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LICENSING SOFTWARE 
RESTRICTED RIGHTS 


OS$/32 TEXT is Licensed softwares subject to restricted rights 
as defined itn the ODeoartment of ODefenseye Armed Service 


Procurement Regulationss ASPRe Paragraph 7-104.9Ca). (Rights 
in Data and Computer Softwarede 


In summaryse the following apply: 


le OS/32 TEXT may be used with the computer for which 
or with which OS/32 TEXT was acquirede 


2e OS/32 TEXT may be used with a backup computer if the 
computer for which or with which oOS/32 $.qTEXT was 
acquired is temporarily inoperativee 


3e OS/32 TEXT may be cooted for safekeesing Carchives) 
or backup purposese 


9. OS/32 TEXT may be modified or combined with other 
softwares Subject to the provision that those 
portions of the derivative software incorporating 
restricted rights software are subject to the same 
restricted rightse 


@e Provided there is no change in ownership of the 
computer for which or with which OS/32 TEXT was 
acquirede the OS/32 TEXT program may de used at 
any installation to which the computer may be 
transferrede 


be License assignment and sublicense facilities are 
provided by Interdata to enable third oarty use 
of OS/32 TEXT. 


Ce Restricted rights for OS/32 TEXT apply only to 
the following parts of the product: 


03-212 OS/32 TEXT 
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This manual describes the usage of OS/32 TEXTs Part Number 
03-212. OS/32 TEXT 38 a program that factlitates the 
production and maintenance of all forms of documentation. 


Users with no previous programming experience can easily 
Learn to use OCS/32 TEXTe Howevers prior to using O0S/32 TEXT, 
the user must have some knowledge of OS/32 file handlings 
task Loadinge and task execution proceduresSye as an *MTM 
terminal user or as _ a console operatore If the user is 
unfamiliar with these proceduress additional instruction 
SrRould be obtained from the Related Documentation listed in 
this programe 


Synopsis of Chapters in This Manual 


This manual provides tutorial material that is directed to 
the new users as well as reference sections that are directed 
to the more exseriencea uS2fre 


Chapters 1 and 2 contain introductory information and should 
be read by all userse Chadter 3 is primarily directed to the 
user who has no previous document formatting experience using 
a computere The use of OS/32 TEXT 48 explained through a 
series of examples that demonstrate the features of OS/32 
TEXT in oe meaningful contexte Chapter 4 which is directed 
more toward the experienced user discusses the capabilities 
provided by OS/32 TEXT. chaoters 5 and 6 are reference 
guides to OS/32 TEXT commands and formatting requests 
respectivelye Chapter 7 explains the use of OS/32 TEXT-II¢ 
a verston that orovides only formatting capanlility. chapter 
& explains error handlinge Appendices contain "pull out" 
reference pages and task establishment information. 


o MTM Terminal User*s Reference Manuals PFubdlication 
Numper 29-591, should oe consulted oy users operating 
OS/32 TEXT at an MTM terminal. 


0 OS/32 MT Operator*s Reference Manual,» Pubdlication 
Number 29-2574, orovides information for the oOS/32 
System operators and should be consulted by users 
operating OS/32 TEXT at the system console. 
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0 OS/32 Edit Userts Manuale Publication Number 29-575, 
describes tne text editing comnands used in 08/32 TEXT 
in greater detail. 


Systen Requirenents 


CS/32 TEXT executes as a segmented user task under 0Q0S/32 
RO4-01 or hignhere The system must include disc support and 
a suitable printing device. 


OS/32 TEXT supoorts both Lower and upper case character 
processing where upper/lower case devices are available for 
text entry and outpute 


when outputting to a Line printers OS/32 TEXT assumes” that 
the first Line available for printing is just below the paper 
perforatione 


This manual was produced using the OS/32 TEXT program 
described herein.e 
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CHAPTER 1 
GENERAL OVERVIEW OF OS/32 TEXT OPERATION 


lel GENERAL 


This chapter describes in general terms the capabilities of 
OS/32 TEXT and how these capabilities are used to produce 
documentse Letters», etce The generation and revision of a 
manual such as this onee with its many revisions from 
inception to final versione is greatly simplified. The 
typist works only on those areas of text that require 
changes; OS/32 TEXT prints the revised dociment with the 
changes incorporated and with the pages properly arranged. 
Thus the often tedious cut-and-paste and retypding tasks are 
eliminated. 


Le2 TEXT ENTRYS CREATION ANO MAINTAINING TEXT 


Initially the typist enters the text of the document being 
prepared in a manner similar to typing on a tyoewriter. 
OS/32 TEXT then retains the text which was entered so thate 
at any time, this text can be manipulated to perform such 
functions as: 

® reviewing typed text 

® error correction 

@® deletions, additions, insertions 

® re-arranging of paragraphs 

e printing 
The text can abso be uniquely identified and "filed" in the 
computer for future processing to perform all the functions 


Listed apove.e If desired» a different file can be keot each 
time a document is revised. 
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1-3 FORMATTING: PRODUCING THE DESIRED DOCUMENT 


To "format" a document the typist describes to OS/32 TEXT how 
the printed form should apoeare The typist does this by by 
inserting the appropriate formatting requests within the 
actual text of the document being prepared. The formatting 
requests are predefined words with an English meanings such 
as PARAGRAPH, INDENTo etce The formattinc requests are 
generally embedded in the text as part of the typing 
operations whenever their function is requirede They can 
also be addede changeds deleteds etces in the same manner as 
has been described for the text itself. 


The formatting requests offer many options to assist the user 
fin producing an appealing document. Some of these options 
ares 

e definition of page dimensions and margins 

® automatic page numbering 

e Left and right justification 

es top and bottom titles 


e centering texte titles 


e multiple spacing 


1e4 VERSIONS OF OS/352 TEXT 


0S$/32 TEXT is provided in two versions in the 08/32 TEXT 
packages Part Number $90-020°3 


1) OS/32 TEXT-I (file name TEXT32-eTSK) is the full 
capability progran providing alt the text entrys 
editing and formatting features described in this 
manuale 


2) OS/32 TEXT<-II (filename TEXT32FM.TSK) 3s a subset of 


OS/32 TEXT=-I providing the formatting capability 
without text entry and editing functions. 
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Installations with limited memory § space may find it 
conventent to use OQOS/32 TEXTe-II. In those installations 
where only 0OS/32 TEXT-II is available, editing functions are 
performed using a separate program, OS/32 EDIT (filename 
EXIT32eTSK as orovided in the OS/22 packages S$90-016)}. 0OS/32 
EIT provides .the identical text entry and editins 
capabilities that are an integral part of OS/32 TEXT-I. 


Throughout this manual the discussion is directed toward the 
primary verston of OS/32 TEXTse OS/32 TEXTeI. The operation 
of OS/32 TEXT-II is explained in Chapter 7. 
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CHAPTER 2 
GETTING STARTED 


2el GENERAL 


This chapter discusses the steps required to make OS/32 TEXT 
operational in your systems: Loading and starting the orogram 
are explained$ interactive operation and batch operation are 
ciscussede 


If you are using an MTM systems it ts assumed that you are 
familiar with the SIGNON/SIGNOFF procedures required to use 
the systeme If you are not familiar with the procedures, 
refer to the MTM Usert*s Reference Manual. 


2e2 LOADING TEXT 


In order to make OS/32 TEXT operational, the program is first 
Loaded into conputer memory from disc. 


OS/32 TEXT must be an estaolished OS task before it can be 
Loaded. The task establishment procedure is discussed in 
Appendix 8. In this discussion it is assumed that 0S$/32 TEXT 
resides in task form on the system disc under the name 
TEXTS 2eTSKe 


Examples follow that illustrate loading OS/32 TEXT din an 
OS/32 or an MTM environment. In the examples, the "*" which 
is output by the systeme indicates that the system is ready 
to accept a command from yous the usere 


In the 0S environment you enter the LOAD command 
followeaq by the TASK command. The TASK command is 
required to set TEXT32 as the currently selected task. 


*LOAD TEXT32eeSeg-size increment 
*TASK TEXT32 


29-677 ROO 2/79 asi 


Only the LOAD command is requirede 
*LOAD TEXT32e9Seg-size increment 


"seg-size increment" in the above examples is an oapotional 
argument used to provide additional memory for TEXT32 working 
Spaces thus generally improving response time of the program. 
Seg-size is an integer argument that represents the amount of 
additional spaces expressed as K-bytese allocated as the 
Pprogram*®s working spacee See Appendix 8B for further 
discussione 


2e3 STARTING TEXT 


After OS/32 TEXT has been Loadeds the START command f{s_ used 
to begin execution of the programe The format of this 
command is the same for both the 0OS/32 and MTM environmentse 
Any one of the following forms of the START comnand may be 
used to start execution of OS/32 TEXT: 


START 

START eCOMMAND=fal 

START sLlIST=fd2 

START sCOMMANOD=fol sLIST=fd2 


The simple form, START by itself, is the commonly used way of 
starting OS/32 TEXT. It causes OS/32 TEXT to automatically 
use the console device (eeges Model 1100+ Carousel) as both 
the command inout and list output device to perform the 
dialog with the user. The console device (often called the 
terminal) is the device at which you enter commands to OS/32, 
MTMe or OS/32 TEXTe 


If the use of the console device for both command input and 
Output is not appropriate for your needsy one of the 
alternate START forms should be used to specify a different 
devicee 
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2esel Command Device: COMMAND = fdil 


The file descriotor fdl specifies the command input device. 
You enter commands to OS/32 TEXT from the command input 
devicee If a command input device is not specifiede commands 
are read from the console devices CON:.- 


2esee List Device: LIST = fd2 


The file descriptor fd2 specifies the device for command 
responsese This device ts called the list aevyice or 
sometimes the command output cevice. 


If fdi is an interactive device (CRT>» Teletypes etce) and 
MC TSts=* js omitted from the START commands command responses 
are output to fdl.e 


If fdl is not an interactive devices the argument "LIST=" is 
required. 


204 COMMUNICATING WITH OS/32 TEXT 


Once TEXT has been started with the START command TEXT 
displays its program identification, followed by the "greater 
than®™ (>) symbole. O8/32 TEXT outputs the > symbol wnenever 
{it expects you to enter a command: 


OS/32 TEXT Rn 


? 
wheres 
Rn is the revision number of the version of TEXT that 
you are using 
> 4s the prompt character indicating that 0$/32 TEXT 
is ready to accept a commard from the user. 
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OS/32 TEXT now expects you to enter a commande For example, 
to tell OS/32 TEXT that you want to enter texts you type the 
command APPEND and then deoress the RETURN kKeye OS$/32 TEXT 
processes your commana and in this cases expects you to enter 
the text that you want to be formattede When you have 
entered your Last Line of text you would indicate to 0OS/32 
TEXT that you are finished oby entering a carriage return 
directly following the ">" output by OS/32 TEXTe OS/32 TEXT 
then expects you to enter another commande At this time you 
may want to review what you have done so fare By entering 
TYPE l= you command OS/32 TEXT to display everything you have 
typed from the first line to the last Linee After the 
display of your text is complete the program is again waiting 
to receive a command from youe 


APPEND and TYPE are examples of commands that you would use 
to tell OS/32 TEXT to perform certain functions. There are 
many more such commands to help you accomplish your taske 
These commands and the functions they perform for you are 
Giscussed in subsequent chapterse 


2064e1 Interactive Mode 


When OS/32 TEXT is used at an tnteractive device such ‘asa 
C28T or Carousels OS/32 TEXT is being used in the interactive 
modee In this modey the following conditions prevail: 


- the LIST argument in the START command can de omitted. 
If the LIST argument is omittede command responses are 
output to the command input devicee 


- error messages are output to the command input device. 


Cetelel Terminal Use 


Very LlLikelye you will find that typing on most terminals is 
easier and quieter than using a typewriter. The keyboard 
Layout is the same as on a typewriter except for several 
additional keys» some of which you will Learn to use. 


Transmission of data to the computer occurs whenever you 
Gepress RETURN at the end of the line you are currently 
tyoinge 
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Note that some terminals do not support Lower case 
characterse This ts important to consider when preparing a 
document. 


An important advantage of a terminal over an ordinary 
typewriter is the ease of error correctione Methods of error 
correction are: 


1) If you are reviewing text that has been entered into 
the computers you use the edtting capability in 
0S /32 TEXT to correct an errore Editing is 
performed by using the commands described in 
subsequent chapterse 


2) If you notice an error before you transmit” the 
current Line to the computere you can backspace to 
the error, correct it and retype the remainder of 
the lLinee 


Alternativelyse you can delete the entire line and 


re-type it. 


The character and Line deletion keys for the Carousels Model 
11009 and Model 1200 are: 


KEY FUNCTION 
CTRL X Voids the tine being typed 
CTRL H Moves the cursor back one 
or spaces causing deletion of 
SACKSPACE character 
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2eoSe2 Batch Mode 


OS/32 TEXT is being used in the batch mode when OS/32 TEXT fs 
STARTed by specifying a noneinteractive device such as a card 
readers as the command inout devicee In this modée there is 
no communication with the user in a conversational mnanner. 


Communication with OS/32 TEXT is performed indirectly by 
using a prepared input sequence of commands and texte I[t is 
possiole to prepare all commands and text on data processing 
cards and store the cards on a disc file using the Spooler, 
or to create a dise file containing commands and text, using 
OS/32 EDIT or the Source Updater. 


In batch modes the following conditions prevail: 
o The COMMAND argument 4s required tn the START command 
o The LIST argument is required in the START command 
o Error messages are outout to the List device 


o ALL user commands are echoed to the List device 


o The first error encountered causes OS/32 TEXT to 
terminate execution as indicated by the message: 


“ENO OF TASK CODE= 2 


The information and explanations in this manual are primarily 
directed toward the interactive user. There are rarely any 
cifferences for the batch user except error handlinge For 
specific batch user considerations for using OS/32 TEXT 
commands refer to the OS/32 EDIT Userts Manuale Publication 
Number 29-5766 
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CHAPTER 3 
INTRQOOQUCTION TO DOCUMENT FORMATTING USING OS/32 TEXT 


Sel INTROOUCTION 


This chapter presents sample sessions showing how to enter 
text and how to produce the desired documente Each session 
introduces several features of 0S/32 TEXT and shows you how 
to use these features to prepare a document. 


To obtain the maximum benefit from these sessions, you should 
perform the e2xamoles at a terminal. The numbers in 
parentheses in the Left margin in the examples correspond to 
the explanations following each examole. 


General Notes: 


o The examples assume that you are familiar with Loading 
and starting OS/32 TEXT as explained in Chapter 2. 


o when performing tie -2xamoles at a terminals you 
depress the RETURN key when you are finished typine 
each Linee Oepressing RETURN sends the Line you have 
just typed to the computer. 


o Whenever OS/32 TEXT displays the > symbol oy itself 
OS/32 TEXT expects you to enter a command. 


o Whenever OS/32 TEXT disolays a number followed by the 
> symbol OS/32 TEXT expects you to enter a Line of 
text or a formatting request. 


Oo CR appears in the examples whenever you should deoress 
RETURN and no other text is to be entered on the Line. 


o Formatting requests and commands are shown in the 
examples in upper case letters to distinguish them 


from the text that you entere However, they can be 
entered in upper or Lower case Letters. 


ZSelel Example 1: Text Entry and Simple Formatting Requests 
This example illustrates how to enter and format texts The 
steos involved are: 


0 Requesting OS/32 TEXT to accept text input 
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(1) 
(2) 
(5) 


(5S) 
(7) 


o Specifying a page length formatting request 
o Reviewing the typed text 


o Requesting formatted output 


The greater than symbol (>) is a prompt from OS/32 TEXT 
tndicating that the program its waiting for you to enter a 
Linee 


The numbers being disolayed when you enter or review text are 
Line numbers that identify each Line you have typed. In 
Subsequent examples you will Learn how these numbers can be 
used to reference a line of text for change or error 
correctione The Line numbers do not become part of your 
formatted output. 


EXAMPLE 1 
At the keyboard enter: 


> 
1 DdePLENGTH 23 

2 This is an example of entering text using 

> >O0OS/32 TEXT. It is very easy to.uSsee 

4  >Let us now make a typping error 

5 dwhich we will 

6 >eorrect 

7 >in example number 2. 

8 >ePARAGRAPH 

9 >You have probably noticed that we are not filling 
10 >the Lines too neatly. 

11 dWe want to show you that O0S/32 TEXT can do this for 
12 Dyou - to nake your jobd easiere 


13 > CR 

TYPE 1-12 

1 ePLENGTH 23 

2 This is an example of entering text using 
3 OS/32 TEXTe It is very easy to uS@e 

4 Let us now make a typping error 

5 which we will 

& correct 

7 dn example number 2. 

8 .ePARAGRAPH 

S93 You have crobably noticed that we are not filling 


10 the Lines too neatlye 
11 We want to show you that O0S/32 TEXT can do this for 
12 you = to make your job easier. 
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(8) 


(9) 


(10) 


(1) 


(3) 


>FORMAT 


This is an example of entering text using OS/32 TEXTe It is 
very easy to usee Let usS NOW make a typping error which we 
will correct in example number 2. 


You have probably noticed that we are not filling the Lines 
too neatlye We want to show you that 0S/32 TEXT can do this 
for you - to make your job easier. 
? 


EXPLANATIONS FOR EXAMPLE 1 


APPENO 


The first command you enter when OS/32 TEXT outputs the 
prompt (>) is the APPEND commande This command teits oS/32 
TEXT to accept Lines of text from youe This command changes 
OS/32 TEXT from the "command mode" to the "text modee" In 
text modee you can enter your text and formatting requests as 
desirede OS/32 TEXT remembers all the text and formatting 
requests that you type. Continue typing the text and 
formatting requests as shown in the examole next to each 
number displayed by OS/32 TEXT. 


ePLENGTH 23 


This formatting request sets the page length to ove used  “*£Ffor 
producing the formatted output of your texte Heresy you set 
the Length to 23 Lines because the screen Length of a CRT is 
24 Lines Longe If you are doing these examples at a CRT and 
you used a Line Length greater than 23 Liness the formattec 
output of Example 1 would disappear from the screene The 
standard page Length normattly used by OS/32 TEXT ts 66 Lines 
Longs ands if the formatted text is being printed on a print 
device, there is no need to use the PLENGTH fornatting 
request. 


Please remember these important rules about formatting 
requests: 


0 Formatting requests always start at the 
beginning of a Line 


o Formatting requests always begin with a voeriod 


o User text cannot be typed on the same tine that 
contains a formatting requeste 


This iS anNeceeejfObd easier. 


Lines 2-7 and 9-12 contain text that you want to format. 
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(4) 


(5) 


(6) 


(7) 


(9) 


(10) 


ePARAGRAPH 


This formatting request tells OS/32 TEXT to begin a new 
paragraphe 


CR 


You enter RETURN in response to a prompt to enter texte in 
order to change 0OS/32 TEXT from text mode to command mode. 
In command mode OS/32 TEXT is ready to accept connands from 
yYyOUe 


TYPE 1-12 

You have terminated text input tin (5) above and you want to 
review your worke TYPE tells OS/32 TEXT to display tre text 
that you entered in Lines 1-12. 

1 ePLENGTHeeeejfOb easier 


This is the display from 9S/32 TEXT in response to your 
command to display the text you previously entered. 


FORMAT 


You have reviewed the text and formatting requests that you 
entereds and now decide to produce the formatted outpute You 
use the FORMAT command to tell OS/32 TEXT to produce the 
formatted output of your texte 


This iSeceefod easiere 


These two paragraphs are the formatted output of your text. 


> 


After the formatting has been completeds the prompt is output 
by OS/32 TEXT and you can now enter another another 0OS/32 
TEXT commands as shown tn Zxample 2. Example 2 uses the text 
that you have entered in Example 1. 


Sele2 EXAMPLE 2: Error Corrections Text Insertion 
and Addition 


This session uses the text that you entered in Example 1 to 
ttlustrate how errors can be corrected and Lines (consisting 
of text or format requests) can be inserted in or added to 
existing text. Finallys the Layout of the formatted output 
of Example 1 is modifiede The steos involved are: 


o Reviewing the existina text 
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(8) 


(9) 


o Inserting formatting requests to change 


- teft and right margins 
- produce doudle spaced output 


o Correcting a typing error 
0 Adding new text 
0 Reviewing all text 


0 Requesting formatted output 


EXAMPLE 2 
At the keyboard enter: 


> 
1 eP LENGTH 23 

2 This ts an example of entering text using 

3 OS/32 TEXT. It is very easy to uSe. 

46 Let us now make a typping error 

5 that we will 

6 correct 

7 in example number 2. 

8 ePARAGRAPH 

9 You have probably noticed that we are not filling 
19 the Lines too neatly. 

11 We want to show you that OS/32 TEXT can do this for 
12 you = to make your job easier. 


>INSERT 1 

1201 SdeLMARGIN 5 
1.02 %e¢RMARGIN =5 
1093 D%eSPACE 2 
12604 OCR 


>TYPE 4 
4 Let us now make a typping error 


>CHANGE /typping/e/typing/ 4 
4 Let us now make a typing error 


>APPEND 

13 >ePARAGRAPH 

14 DSIn example number 2 you will Learn how Lines 
15 >cean be inserted in existing text, 

16 >how to correct a typing error from a 
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17 >previous example 

18 >and how to add text at the 
19 >dend of existing text. 

20 >CR 


(10) TYPE 1- 
1 ePLENGTH 23 
1e01 eL MARGIN & 
1602 eRMARGIN =5 
1203 eSPACE 2 
2 This is an example of entering text using 
3 OS/32 TEXT. It is very easy to uSee 
4 Let us now make a typing error 
5 that we will 
5 correct 
7 In example number 2. 
8 ePARAGRAPH 
9 You have probably noticed that we are not filling 


10 the Lines too neatly. 

11 We want to show you that OS/32 TEXT can do this for 
12 you =~ to make your job easiere 

1 ePARAGRAPH 

14 In example number 2 you will learn how Lines 

15 can be inserted in existing texts 

16 how to correct a typing error from a 

17 previous example 

18 and how to add text at the 

19 end of existing texte 


(11) DPFORMAT eHALT 
(llad ENTER RETURN WHEN READY 


(Lib) OCR 


(12) This is an example of entering text using 0S/32 
TEXT « It is very easy to us@e Let us now make a 
typing error that we will correct in example 


number 2. 


You Rave probably noticed that we are not filling 
the Lines too neatlye We want to show you that 
(13) >CR 
(14) OS/32 TEXT can do this for you - to make your job 


e3siere 
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(15) 


Oo) 
(4) 


In example number 2 you will Learn how Lines can be 
inserted in existing texts how to correct a typing 
error from a previous examole and how to add text 
at the end of existing texte 


> 


EXPLANATIONS FOR EXAMPLE 2 


TYPE. a= 


The TYPE 1=- command tells OS/32 TEXT to display all text from 
tne first Line to the Last Line entered so far. If you do 
not enter a Line number following the cash "=", the Last line 
entered is implied. 


INSERT 1 


This command allows you to insert text or formatting requests 
after the Line number referenced in the command. In this 
case you wish to insert new Lines following Line 1. Notice 
how the inserted Lines are numberede You may continually 
insert Lines until you tell OS/32 TEXT that you are finished 
entering Lines. In (6) you tell oOS/32 TEXT that you are 
finished inserting Lines. 


eL MARGIN 5 


These are formatting requests controlling the margin 
settings. In this example, the standard margin settingss 12 
(Left) and 74 (Cright)s« are initially in effect. By using the 
RMARGIN and LMARGIN requests you have changed the margin 
settings so that the text will be formatted using 17 and 69 
as Left and right margin settingss respectively. LMARGIN 
adjusts the Left margin to 17 (12435). RMARGIN adjusts the 
right margin to 69 (74-5). 


eSPACE 2 


This formatting request tells OS/32 TEXT that the formatted 
output is to be double spaced. 


CR 


Entering a CR in response to a text input request from an 
INSERT command switches OS/32 TEXT back to command mode. 
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(7) 


(8) 


(9) 


(10) 


(11) 


TYPE $% 
Here you review a Line that contains an error. 
CHANGE /typping/e/typing/ o4 


To correct errors ina Ling you use the CHANGE commande In 
the commande you first enter the characters you want to 
change and second the replacement characterse In this case 
you want to change "typping"™ to "typinge" 


A slash is required to enclose the characters you want to 
change and the replacement characters. The slash "/" fs 
called a delimiter. The delimiter can be any character’ that 
is not part of the character string itself. You may always 
use a slash unless a slash is part of the character string 
you want to change or a slash is part of the new string. In 
this case you would substitute a character of you choosing 
for the slash. 


The number 4 Ys the number of the Line in which the change is 
to be performed. : ; 


After OS/32 TEXT has changed the line, it displays the new. 
contents of the line so that you may verify the correction. 


APPENO 


The APPEND command was used in Example 1 to enter Lines of 
text and fornatting requestse This command always causes 
Lines to be added at the end of existing Lines. 


In Example le no Lines exitsted when you used APPEND. 
Consequently, the first line number assigned to your input 
Line was nmumber 1. Her@s you use APPEND again. Since Line 
i2 is the Last lines the next Line assigned to your input jis 
Line 13. 


tee. Le 


You request OS/32 TEXT to display your text Lines from Line 
1 to the Last line. 


FORMAT  »HALT 


You have reviewed your text and formatting requests in (10) 
and decided to obtain the formatted output of your texte 


The comma is required to properly position "HALT" as the 
second argument of the commande. Chapter 5 explains the use 
of the comma, aut for the surpose of these examples you need 
not be concerned with its use. 
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(lla) 


(115) 


(12) 


(13) 


(14) 


(15) 


HALT tells OS/32 TEXT,» to stop output of your formatted text 
at the beginning of each pagee If you do these examoles on 
a CRTs this allows you to study each page before the next one 
is displayed.ej More importantlys if your formatted text iis 
being printed on a device where the paper has to be fed 
manuallys the use of HALT allows you to change the paper 
before each page is printed. 


To tell OS/32 TEXT that you are ready for the next page to be 
printed, you enter RETURN. 


ENTER RETURN WHEN READY 

When HALT is given in the FORMAT commands thts message is 
disolayed prior to outputting the first formatted page. At 
this time you may want to adjust the paper used for output. 


CR 


You enter RETURN to tell OS/32 TEXT to output the formatted 
Page e 


This iSeeejfob easiere 


This is the formatted output of page 1e OS/32 TEXT waits at 
the end of the pages until you enter RETURN. 


CR 
This causes OS/32 TEXT to resume output. 
In examole@eeeextsting texte 


Thts is the formatted output of page 2. OS/32 TEXT again 
waits at the end of the page. 


> Since there are no more pages to be outpute DS/32 TEXT 
returns to Commnand Modee 2lease proceed to Example 2. 
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Zeled 


EFXAMPLE 3: Text Searchs Line Deletions 
Saving and Retrieving Stored 
Texte Exit from 08/32 TEXT 


This example presents several very useful text manipulation 
featuresSe You are shown how to: 


Search the text for certain words or characters 
Delete text 

Save text in a disc file 

Retrieve the saved text from the disc file 


Terminate use of 0OS8$/32 TEXT 


This session uses the text created in Examples 1 and 2e 


EXAMPLE 3 


At the keyboard enter: 


>TYPE 1- 

1 ePLENGTH 23 

1eO01 eL MARGIN 5 

1.92 eRMARGIN =5 

1203 eSPACE 2 

2 This is an example of entering text using 

3 OS/32 TEXT. It is very easy to uS@e 

4 Let us now make a typing error 

5 which we will 

5 correct 

7 in example number 2, 

8 ePARAGRAPH 

9 You have probvably noticed that we are not filling 
1¢ the Lines too neatlye 
il We want to show you that OS/32 TEXT can do this for 
12 you - to make your jod easitere 
13 ePARAGRAPH 

14 In example number 2 you will learn how Lines 

Aes can be inserted in existing text, 

16 how to correct a typing error from a 
t ODrevious example and 

18 how to add text at the 

19 end of existing text. 
3-10 29-677 ROO 2/73 


(2) DFIND SePARAGRAPH/ 91-19 
8 ePARAGRAPH 
12 ePARAGRAPH 


(2a) >FIND =O0S/32 TEXT=91203- 
5 OS/32 TEXTe It is very easy to usee 
11 we want to show you that OS/32 TEXT can do this for 


(3) PDELETE &@ 
(4) POELETE 13= 
(5) ED a ae 
i ePLENGTH 23 


1-01 eL MARGIN & 
1202 eX MARGIN -5 
L603: «SPACE 2 


2 This is an example of entering text using 

S OS/32 TEXT. It ts very easy to uUS@e 

4 Let us now make a tyding error 

> which we will 

correct 

PE in example numoer 2. 

° You have probably noticed that we are not filling 

10 the Lines too neatly. 

Li We want to show you that OS/32 TEXT can do this for 

12 you -- to make your job easier. 
(6) >SAVE EXAMPLE3-RVO 
(7) >TYPE 12 

12 You = to make your job easier. 
(&) DELETE 1- 
(9) >TYPE 1- 
(10) INO OS/32 TEXT 


(il) >GET EXAMPLE3.RVO 


(12) PTYPE. i= 


1 ee? LENGTH 23 

2 eL MARGIN 5 

5 eRMARGIN -5 

4 eSPACE 2 

5 This is an example of entering text using 

6 OS/32 TEXT. It is very easy to usee 

7 Let us now make a tyoing error 

rs) which we will 

9 correct 

19 in example number 2. 

J You have probably noticed that we are not filling 
12 the Lines too neatly. 

iS we want to show you that OS/32 TEXT can do this for 
14 you =~ to make your jod easter. 
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(13) 


(14) 


(15) 


(2a) 


(4) 


PEND 


ENO OF TASK COODE= 0 


EXPLANATIONS FOR EXAMPLE 3 


TYPE 1- 

You review all the text you have typed so fare 
FINO/ePARAGRAPH/e1=-19 

FIND is the 0OS/32 TEXT command that allows you to search your 
text for the presence a specified character stringe Here you 
want to Locate the Lines that contain the formatting request 
"PARAGRAPH". The slashes "/" delimit the characters for 
which you are searchinge (The delimiter can be any character 


but may not be part of the string it defines.) "1-193" tells 
OS/32 TEXT to search from Line 1 through Line 19. 


Each time 0S/32 TEXT finds a match in its searches it displays 
the Line number and the entire text of that Line. 


FIND =QS/32 TEXT=91-03- 
Note that you are using a different delimiter to define the 
character string.e ALso note that spaces can be part of the 


string you are searching fore 


"T.e03=-" tells OS/32 TEXT to search from Line 1-03 to the end 
{Last Line) of text. 


DELETE 8 


The CELETE command allows you to delete a single line or a 
Group of consecutive Linese Here, you deleted Line 8. 


DELETE 1352 


Here you deleted a consecutive group of Lines from Line 13 to 
the Last line. 


EYPE. T= 


You tell OS$/32 TEXT to disolay all text and observe that 
Lines 8 and 13-19 have been deleted. 
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(3) 


SAVE EXAMPLES eR VO 


The SAVE command allows you to store your current text in a 
disc file. This text can be retrieved at a Later time to 
continue your worke 


It may be helpful at this time to discuss how the computer 
can "file" your work for yOue 


In this example you "saved" your text in a file on the disce 
A disc % a magnetic device that contains one or more 
platters similiar to record platters. These platters are 
used to store texte or in fact any data you might specify. 
You can not only store information on thes2 disc oplatterss 
but also read it backs or delete ite if the information is no 
Longer required. 


A 4-drawer office filing cabinet can be compared to ae disc 
devices where each drawer represents a record platter. when 
you store information on a discs the infornation is placed 
into a "file" on any one of the olatters. The computer 
decides on which platter to place the file. 


Fach file has its own unique name. The computer keeps. an 
index of these file names and the Location of files on the 
disce SOs when you ask for a files the computer can 
determine if it has the file you want and where to find it on 
the disce This procedure is quite similar to the filing and 
retrieving of file folders in alphabetical (or similar) order 
tin each drawer of a filing cabinet. 


In the example using the SAVE command you entered 
"EXAMPLES .RVO". This is the file name (also called file 
Gescriptor) under which you want the computer t> file 
(record) your texte 

Chapter 5 describes the rules on naming a file. 

TYPE Le 

OS/32 TEXT stilt remembers your text after you have saved it 
in the disc file. The computer simply made a copy of ite 
Note that if you now alter this texts the disc file does not 
get changed. 

DELETE 1- 

Here you request OS$/32 TEXT to delete all Linese After 
celeting alt Lines OS/32 TEXT outputs a message telling you 
that all Lines have been deleted. 

TYSE le 


You wish to display all lines. 


29-677 ROO 2/73 I-15 


(10) 


(11) 


(12) 


INO OS/32 TEXT 


This is a message output by OS/32 TEXT in response to your 
request in (9). Since you deleted all Lines in (8), there is 
no more text to displaye The text exists now only in the 
disc file. 


GET EXAMPLE3.RVO 


GET is the command used to read text from a disc filee Here 
you are retrieving the text which you saved in file 
EXAMPLES <eRVOQ -« 


It does not matter that you are reading the text during the 
Same @xampole session in which you saved it e You can do this 
any timee You could have stopped using OS/32 TEXT after the 
SAVE commands and Loaded the program again then or the next 
daye As long as the file EXAMPLE3-RVO existSe you can get 
your text daacke 


Please remember these important facts when using the GET 
command: 


When you read the text files you do not Lose that file. 
The computer simply copies the text from the file and 
makes it available to oOS/32 TEXT. You can now 
manipulate the text again as you have done in the 
examolee The original file remains stored on this 
disce You are only working on a copy of the file. 


The GET command always deletes any currently existing 
Lines of text before reading the requested filee You 
should always SAVE the text you were working on before 
entering GET. However, if you forget to SAVE your text 
before entering GETs OS/32 TEXT gives you a reminder 
meSSage@e 


As the text is read from the files Line numbers 
starting with 1 are assigned to each Line of texte 


eee. = 


Here you see that you have successfully retrieved our text. 
Notes alsoe that the Lines have been renumoerede. 
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(13) 


(14) 


(15) 


eNO 


This command terminates the operation of OS/32 TEXT and 
returns control to the operating system. 


If you createde chan3zed or added any text and had not’ saved 
ite a message ts disolayed to remind you? 


REMINDER = SAVE YOUR CURRENT OS/32 TEXT 
At this time you have a second chance to Save your text. 


Typing a second END command terminates the operation of 08/32 
TEXTe If you did not save your texts it will be Loste 


END OF TASK CODE= 0 
This message indicates termination of OS/32 TEXT. 


* 


The * indicates that the operating system is ready to accept 
a command from youe 


Perhaps at this time you might want to do some of your own 
text nanipulations using the commands and formatting requests 
you have been shown so fafre 


If you want to save some texte use the file name [XAMPLES-RVI 
or make up your own name as described in Chaoter 5. 


Sele4 EXAMPLE 42 Page Layouts Page Titles 
and Numoers, Footnotes and 
Various Line Control Requests 


In this examples the emphasis is on the use of formatting 
requestS,» some of which you are already familiar with from 
previous examples» and a number of useful new ones. 


You will be shown how to adjust oage marginss Now to add top 
and bottom page titles and page numberss and how to add a 
footnote in your text. 


Furthers you will specify various Line control requests to 
vary the appearance of your text. And finallys you will add 
comments for your own use in the text of the document which 
you are preparinge The steps involved are; 
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0 Inserting page layout requests 


o Inserting top and bottom page title requests with 
page numbering 


o Entering text with various Line control 
requests 


o Adding a footnote 


o Using the COMMENT request to explain 
some of the previous steps 


0 Requesting formatted output of Example 4e 
This 2axample assumes that you have terminated using 0OS/32 
TEXT in Example 3. If you have not done soy please do it now 


and then load and start 0S/32 TEXT again as explained in 
Chapter Qe 


EXAMPLE 4 


At the keyboard enter: 

>APPEND 

1 «COMMENT SPECIFY PAGE LAYOUT AND LINE SPACING 
2 >eMARGIN 15966 

3 >eTMARGIN 3 

4 >eBMARGIN 3 

5 DePLENGTH 23 

6 >eSPACE 2 


7 DeCOMMENT SPECIFY TOP & BOTTOM PAGE TITLES AND NUMBERS 
B@ DeSTILE !$!O08/32 TEXT!IEXAMPLE 4!PAGE &! 


9 D>eBTITLE // PAGE % J// 


10 dSeCOMMENT ENTER DOCUMENT TEXT AND FORMAT REQUESTS 
Lil DeCENTER 


12 >sUNDERSCORE 


13 >Exampole Number 4 
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(13) 
(14) 


(15) 


(16) 
(17) 
(18) 


(19) 


(20) 


(21) 
(22) 


(23) 


(24) 


(25) 
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>PeSKIP 2 
P>eRJUSTIFY OFF 


>This example illustrates many of the formatting 
Yeapabilities of OS/32 TEXT. The title "Example Number 4" 
>wtill be centered between the margin settingse 
>The Lines of this paragraph wilt not be spread to 
>touch the right margin 
>because the ".RJUSTIFY" 
>eSKIP 2 


format request is OFF. 


PeRJUSTIFY ON 
>eL MARGIN +5 
>PeRMARGIN <5 


>eSPACE 1 

>This passage wilk stand out in your text oecause it 

>is tyoed in narrower margins and single spaced 

>Linese 

>We want to illustrate the control you have to 

>change the spacing and margin settinas. 

>Note that the lines are spread out to touch 

>the right margin because we specified "eRJUSTIFY ON".(#) 
>e COMMENT RETURN TO ORIGINAL MARGIN SETTINGS ANDO 

>e COMMENT ADO A FOOTNOTE. 


DeL MARGIN RESET 


>eRMARGIN RESET 
>eFOOTNOTE BEGIN 


>(*) This is an example of a footnote in your texte 
>The footnote will be printed at the bottom of the 
>current page and continued on the next page 

>if not enough space is available. 


PeFQOTNOTE END 


>ePARAGRAPH +10 
>The *.COMMENT" formatting request used throughout example 
>number 4 is intended to aid you in preparing 

>and maintaining document text. This feature allows 
>you to keep notes in the text regarding its preparation 
>and formattinae The text typed on the same Line 

>with the request 

>does not aopear 

>in the formatted output of a document. 

>CR 


(26) 


(27) 


(28) 


(29) 


(30) 


>TYPE 1-20 


1 COMMENT SPECIFY PAGE LAYOUT AND LINE SPACING 


20 touch the right margin 


DTYPE 21-42 


21 because the *.RJUSTIFY" format request is OFF. 


42 if not enough space is available. 


>TYPE 43- 
43 eFOOTNOTE END 


52 tn the fornatted output of a document. 
>SAVE EXAMPLES eRVQ 
>FORMAT eHALT 


ENTER RETURN WHEN READY 
>CR 
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(31) 


OS/32 TEXT EXAMPLE 4 PAGE 1 


Example Number 4 


This example illustrates nany of the formatting 
capabilities of OS/32 TEXT. The title "Example 
Number 4" will be centered between the margin 
settinagse The Lines of this paragraph will not be 
spread to touch the right margin because the 


".ZRJUSTIFY™ format request is OFF. 


PAGE 1 


>CR 
OS/32 TEXT EXAMPLE 4 PAGE <@ 


This passage will stand out in your text 
because it is typed in narrower margins 
and single spaced Linese We want to 
fllustrate the control you have to 
change the spacing and margin settings. 
Note that the lines are spread out to 
touch the right margin because we 
specified ".RJUSTIFY ON". (*) 


(*#) This is an example of a footnote in your text. 
The footnote wilt be printed at the bottom of the 
current page and continued on the next page if not 
enough soace is available. 


PAGE 2 
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(34) 


(35) 


(36) 


(2) 


(3) 


(4) 
co) 


(6) 


>CR 
OS/32 TEXT EXAMPLE 4 PAGE 3 


The ",COMMENT"™ formatting request used 
throughout example number 4 is intended to aid you 


in preparing and maintaining document text. This 
feature allows you to keeo notes in the text 
regarding its preparation and formatting. The 


text typed on the same Line with the request does 
not appear in the formatted output of a documente 


PAGE 3 
> 


EXPLANATIONS FOR EXAMPLE 4 


APPEND 


The APPEND command tells OS/32 TEXT to accept and remember 
your Lines of text and formatting requests. 


eCOMMENT SPECIFY PAGE ce eSPACING 


This special formatting request allows you to type notes’ for 
your own uSé@s interspersed within the document text. These 
notes do not become part of the printed document. 


eMARGIN 15966 


Tris request sets the absolute left and right tnargins 
respectively to be used for the formatted outout of the 
documente The numbers represent the column numbers, counted 
from left to right. 


eTMARGIN 3 
eBMARGIN & 


These requests tell OS/32 TEXT the number of slank Lines that 
will appear at the top and bottom of each page. 


ePLENGTH 23 


This request soecifies the aosolute number of Lines per page 
in the formatted outpute This number generally corresponds 
to the physical page size of the device used for printed 
outpute Formatting requests TMARGIN and BMARGIN are offsets 
within these Limits. 
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(7) 


(8) 


(5) 


(10) 


(11) 


(12) 


(135) 


€14) 


eSPACE 2 


This request causes double spacing of all output Lines except 
text appearing in a footnote. 


eTTITLE !0S8/32 TEXTYIEXAMPLE 4!IPAGE %! 
This request ssecifies that three headings should de printed 
at the top of each page, Each heading is defined by a "18 
delimiter. In the formatted output, the titles appear as 
follows: 

o OS/32 TEXT 4s Left justified 

oO EXAMPLE 4 4s centered 

Oo PAGE % 1s right justified 
The third heading contains the page numbering symbol "%", 
The % symbol is replaced on each page by the computed page 
numbere OS/32 TEXT does page numbering for youe 
eB8TITLE // Page %* s/s 
This request is the same as TTITLE in ail respects except 
that it affects the bottom of a pagee Note that you specify 
only the center title. (A different delimiters, "/", is 
entered to indicate that you have a choice of symbols.) The 
Left and right titles are emptye The page symbol "“%" 4s 
treated as described for TTITLE. 
eCENTER 


This request causes only tne next Line of text to be centered 
between the margin settings. 


eUNDERSCORE 

This request causes only the next line of text to be 
underscorede If your formatted output is directed to a CRT. 
the underscoring does not appear on the screen. 

Examole Number 4 

This is the "next Line of text" for the requests given in 
(10) and (11). "Example Number 4" witk be both centered and 
underlinede 

eSKIP 2 

This request causes 2 blank Lines to be output. 

eRJUSTIFY OFF 

This request causes all sunosequent document text Lines to be 


Left justified only. 
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(15) 


(16) 


(17) 
(18) 


(19) 


(20) 
(21) 


(22) 


C23) 


(24) 


(25) 


This example illustrateseeerequest is OFF. 


These are the only document text lines that are to be left 
fustified. 


eRJUSTIFY ON 


Here you request that right justification of document’ Lines 


is resumede 


eL MARGIN #5 
eRMARGIN @5 
the 


with these requests you narrow the margin settings from 


original settings that you specified in (3). The new values 
are NOws. 
Old Value Change New Value 
o Left margin 15 + 5 = 20 
o Right margin 66 - S = 61 
eSPACE 1 
This request specifies ‘that all subsequent document text 


Lines are to pe single spaced. 
eLMARGIN RESET 
e® MARGIN RESET 


These requests cause the margin settings to be 
their values prior to their last change. 
margins are again 15 and 66 respectivelye 


restored to 
The Left and right 


eFOOTNOTE BEGIN 

eFOOTNOTE END 

These requests delimit the Lines of text 
printed as a footnote. 


that are to be 


ePARAGRAPH #16 


This request skips lines and then indents the next Line of 
text to begin a new paragraphe The next Line is indented 10 
spaces and 2 blank lines appear to separate the following 


Daragraph from the preceding text. 
CR 


OS/32 TEXT is now in command 
Input of a commande 


You terminate text input. 
awaiting 


mode 
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(26) 
ef) 
(28) 


(29) 


(30) 


C329 


(32) 


C537 


(34) 


(35) 


TYPE 1-20 

TYPE 21-42 

TYPE 43- 

Here you request OS/32 TEXT to display the Lines that you 
have typed so fare with each TYPE command you specify the 
Line numbers you want to reviewe 

SAVE EXAMPLE4S.RVO 


You save the typed text and formatting requests’ that 


entered in a disc file named EXAMPLE4.RVO. 


you 


FORMAT eHALT 


You request OS/32 TEXT to produce the formatted output of the 
text that you entered. OS/32 TEXT will halt at the beginning 
of each page until you enter a RETURN to continue. 


OS/32 TEXTeeeePAGE le 


This is the formatted output of page l. 


CR 

This causes OS/32 TEXT to resume output of the formatted 
texte 

OS/32 TEXTe eee AGE 20 

This is the formatted output of page 2. 

Gs 

This causes OS/32 TEXT to resume output of the formatted 
texte. 

OS/32 TEXTeeeeP AGE 3 

This is the formatted ere of page 3. 

> 

Since no more oages are to pe outpute OS/32 TEXT returns to 


command modeée 
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Zele5 EXAMPLE 53 Tad Setting and Table Formatting 


In this examples you are shown how to set taoulation stops in 
OS/32 TEXT and how to produce text in table form. The steps 
involved are: 


0 Setting tabs 
o Typing table text and associated formatting requests 
o Saving the text tn a disc file 


o Requesting a formatted output 


There are two ways to add text itn table form in your 
documents? by using either the BLOCK requests or the KEEP 
requeste These requests are used to position a tasle within 
the document you are producinge 


RLOCK 3s used to position the table "in contexte" "In 
context" means that the table must be printed wnere it 
appears in your texte The BLOCK BEGIN and S8LOTK END 
formatting requests delinit the text of an "in context" 
bDLocke .If the table does not fit on the current pages it is 
printed at the too of the next page and continued on 
suosequent pages until the entire table is printed. The 
remainder of the current page is left blank. 


Tne KEE? formatting request allows the tabdle to be odIrintedc 
out of context from where tt appears in your texte A table 

rinted out of context ts referred to as a "floating keep." 
:* the tapnle does not fit on the current pages the current 
page is not Left blank out ts filled with text which appears 
In your document following the table. To specify a table to 
be porintec out of context the KEE® BEGIN and KEZP END 
formattince requests are used to delimit the taolee 


This examole demonstrates the use of the 3LOCK reouest to 
Q9roduce the taale in context within the document. 


CN 
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(4) 


EXAMPLE 5 


At the keyboard enter: 


>DELETE 1- 


DOPTION TAB=39593504e34936 


>OPTION TAB 
THE TAS CHARACTER IS ’ 


> 
1 
2 
be 
4 
5 
6 
i 
e 
9 
1 


5 30 34 «36 


APPEND 


>ePLENGTH 23 

>eTMARGIN 3 

>eSMARGIN 3& 

>This example shows how to add a table as an "In Context 
>Block"™ in your texte 

>Since the table is too Long to fit on the same page with 
>this texts it is printed starting at the top of tne 

>next Dagee 

>ePARAGRAPH 


0 >Note that the remainder of this page is blank! 
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Ll >e COMMENT NOW WE TYPE TRE TABLE WITH ITS FORMAT REQUESTS 


(5) L2 >eB.OCK BEGIN 
(6) 13 DS.NOFILL 
(7) 14 >See CENTER 

15: DSACTORY COSTS 
(8) 16 >eLMARGIN #€10 
(7) L7 SeINDENT =5 


18 DADMINISTRATIVE COSTS 


(10) 19 >TO PRODUCE A$3$460,600-00 
20 >TO ENGAGE SECOND SHIFT$3150+000-00 
21 SMAINTENANCE COST PER MACHINES $3250.00 
22 YeSKIP 1 
23 DeINDENT =5 
24 DPROOUCTICN COST 
25 DSDPRODUCT AsS3$3800.00 
26 >sMATERTALS 3800-00 
of >$sMACHINE HOURS353200.00 
28 >3MAN HOURSS53200200 
29 PeSKIP 1 
30 De INOENT <5 
31 >LABOR COST 
32 D>FIRST SHIFT (FER MAN HOUR) 555535200 
33 SSECOND SHIFT$$533445 
34. Desk IP 3 
35 DeINOENT 5 


(i1) 75 DNIJIMBFR OF AVAILABLE MACHINESS53$3 430.00 
(12) 37 >eBLOCK END 
(13) 38 >eL MARGIN QESET 
(14) 59: Se FP LEL 
40 >If the taole had been specified as a 
41 >"Floating Keen", this text would have seen 
42 >orinted on the dage preceding the table! 


(15) 43 DCR 


(16) DPINPE 18=36 
18 ADMINISTRATIVE COSTS 


19 TO PROOUCE A 400,000.00 
20 TO ENGAGE SECOND SHIFT 1509000.00 
21 MAINTENANCE COST PER MACHINE 250.00 
2c #ShiP J 


235 seINDENT <8 
24 PRODUCTION COST 


2m PROOUCT <A 800.00 
26 MATERIAL 200-00 
28 MACHINE HOURS 2090.00 
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(17) 


(18) 


(19) 


29 eSKIP 1 
30 eINDENT <5 
31 LABOR COST 


32 FIRST SHIFT (PER MAN HOUR) 3-00 

30 SECOND SAITET 3045 

34 eSKIP 1 

35 eINDENT <5 

36 NUMBER OF AVAILABLE MACHINES 450.00 


P>SAVE EXAMPLES RVI 


>FORMAT «@RALT 
ENTER RETURN WHEN READY 
>CR 


This example shows how to add a table as an "In Context 
Block" in your text. Since the tadle is too long to fit on 
the same page with this textes it is printed starting at the 
too of the next page. 


Note that the remainder of this page is blank! 


>CR 
FACTORY COSTS 
ADMINISTRATIVE CCSTS 
10. PROOUCE 400,000.00 
TO ENGAGE SECOND SHIFT 150000.00 
MAINTENANCE COST PER MACHINE 259-00 
PRODUCTION COST 
PRODUCT A 800.00 
MATERTAL G00 .00 
MACHINE HOURS 200.90 
MAN HOURS 200-00 
LABOR COST 
FIRST SHIFT (PER MAN HOUR) 3200 
SECOND SHIFT 5045 
NUMBER O- MACHINES AVAILABLE 450.00 
>CR 


Tf the tasle had been specified as a "Floating Keep", this 
text would have been printed on the page preceding th2 taole! 


> 
EXPLANATIONS FOR EXAMPLE 5 
DELETE 1- 
This command deletes all text and formatting requests that 


were entered as part of Examole 4. 
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(2) 


OPTION TA82=3 45030234936 


The OPTION command is used to set tabulation stops at columns 
5930934 and 36 and specify a tab control charactere The tab 
control character is used to skip from one tad position to 
the nexte The semicolon (3) is selected as the tad control 
charactere You may specify any character that will not 
appear in the text which you will be entering. 


Tabulation control with OS/32 TEXT is different from a 
typewritere It is important that you rememoer these points: 


o When you type the tao control characters the carriage 
(or cursor on aCRT) does not move to the actual column 
of a tab stope ALL you will see is the tad control 
character you typed. OS/32 TEXT internally adjusts the 
text Line to the selected tab stop. When you review 
your text using the TYPE command, the text appears in 
its tabular form. 


o The second difference concerns the selection of a 
specific tab stop. Suppose you did enter text that 
extends beyond the first tab stop and you want to skip 
to the second stop to continues. On a typewriters you 
would depress the tabulation key once. In OS/32 TEXT s¢ 
you have to enter the tad control character twicee Once 
for the stop you passeds secondly for the stoo where you 
want to continues typing! 


o Each time you start OS/32 TEXT you must set the tabs if 
you wish to use tabdSe OS/32 TEXT does not rememoer tab 
settings from a previous session. 


CPTION TAB 


This command displays the currently specified tao control 
character and the tad stoposSe 


APPEND 


This command tells OS/32 TEXT to accept and rememoer your 
text and formatting requestSe 


eBLOCK BEGIN 


This formatting request tells OS/32 TEXT where the in context 
olock of text sdegiInse 


eNOFILL 


This formatting request allows the user to control the output 


format of texts in this case the format of the tasle. The 
request suspends filling Lines,» suppression of blanks» and 
right and left justification. Margin specifications and 


centering are adhered toe 
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(8) 


(9) 


(10) 


ae 


(13) 


(14) 


It is important to rememoer that when -e-NOFILL is in effecte 
an input Line cannot contain more characters than space is 
available in the outout Line. The availble space in the 
output Line is determin2zd sdsy the Line width spacification 
minus the current margin settings. 


eCENTER 


This formatting request causes the next Line of text to be 
centered between the current margin settingse 


eL MARGIN +10 

You adjust the Left margin for the eit. 

eINDENT <5 

This formatting reauest causes outdenting of the next text 
Line by five character positions. Outdenting positions the 


next Line of text to the left of the current left marain 
settinge 


TO PRODUCE As53400 9000.00 


This is a line of text for the table. Note that you have 
twice entered the tad control character "5", first to skip to 
position 5s then to oosition 305. Thuse "400.ee0." wilt appear 
in the table at character sosition 30. 


NUMBER OF eees33 300000450.00 

This is another text Line of the table.e. Here you deoressed 
the tab control character three times to skip over positions 
5 and 30 to 34. At position 34 you type five spaces (9) and 
then the number 450.00. The spaces are required to 
comoensate for the outdenting of this line by § character 
positions (see request on Line 35). 

eBLOCK END 


This formatting request delimits the ena of the in context 
clocke 


eL MARGIN RESET 


You return the Left margin setting to the value that was in 
effect orior to the beginning of the taodle. 


eP ITLL 
This formatting request is the opposite of NOFILL. It 


restores the formatting features suspended in (7) by the 
NOFILL request. 
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(16) 


(17) 


(18) 


(19) 


(20) 


(21) 


(22) 


(23) 


FILL tin conjunction with LUUSTIFY and RUJUSTIFYs causes’ the 
outout text lines to be left and right justified as you have 
seen tnroughout the examples. 

CR 


You terminate input of text and formatting requestse 0$/32 
TEXT is now In command mode awaiting input of a command. 


TYPE 18-36 

You review the text Lines that were entered using tne tab 
feature in OS/22 TEXT. The displayed lines now reflect the 
tabulation selected during tydDinge Note that the number 
column in Line 35 is offset by the five spaces you entered. 
In the formatted outpute the numbers will be aligned properly 
because this Line is outdented by five character positions. 
SAVE ZXAMPLE5e8VO 


The SAVE command stores the text and formatting requests in 
a disc file named EXAMPLESeRVO. 


FORMAT eHALT 

You request a formatted output of the text in examale 5. 
Formatting will be halted at the beginning of each page until 
you depress RETURN to continues 

This exampleeeeis Olank! 

This is the formatted output of page le 

CR 

Continue with formatted output of next page. 


FACTORY COSTS «2 e450.-00 


This is the formatted output of page 2 containing the in 
context table. 


If the tableeeepreceding the table! 
This is the formatted output of page 3. 
> 


No more pages to outpute OS/22 TEXT returns to command modee 
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ZeleG& EXAMPLE 62 Merging Texts Automatic Dating 
and Request to "break" an Qutput 
Text Line 


This example presents the use of three additional formatting 
features. 


The first and most important one is the IMBED request. This 
request allows you to merge text from another disc file into 
the text of the document which you are currently formatting. 


The second feature ts a group of requests which perform 
automatic dating functions for youe They insert the date and 
times which are maintained by the computere into the 
formatted output of your document. 


The third feature is the BREAK request. The BREAK request 
temporarily suspends filling of an output text Line when FILL 
is in effect. 


This example uses the text from Example 5 which was saved in 
file EXAMPLES-eRVO~- The steps are: 

o Typing text and formatting requests 

Oo Imbedding text from dise file 

o Specifying BREAK in text 


o Requesting date and time 


EXAMPLE 6 


At the keyboard enter: 
>DELETE 1- 


>APPEND 

ll DdePLENGTH 23 

2 >In this example we show how you can 

3 Ddinsert the text from a file into the formatted 
4  >text output streame 

5 >We will use the text from example number 5 

6 Owhich is contained in file EXAMPLES5.RVO 

T Dand insert it after this sentence. 

8 DeSKIP 1 
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(3) 


(9) 


(10) 


(11) 


9 DeIMBED EXAMPLES eRVO 


10 >eSKIP 

11 >This passage will appear tn the formatted output 
12 >following the text from the inserted filee 

13 >d>eSKIP 1 

14 D>eLMARGIN #15 

15 >This example was concluded on 


16 >eBREAK 
17 >eMONTH 
18 >eDAY ¢ 


19 DeYEAR 
20 dat 


21 DeTIME eo 
22 OCR 


>FORMAT eHALT 
ENTER RETURN WHEN READY 
2CR 


In this example we show how you can insert the text from a 
file into the formatted text output streame We will use the 
text from example number 5 which is contained in file 
EXAMPLE5-eRVO and insert it after this sentencee 


This example shows how to add a table as an "In Context 
Block" in your texte. Since the table is too long to fit on 
the same page with this texte it is printed starting at the 
top of the next page. 


Note that the remainder of this page is blank! 


222¢ 29-677 ROOD 2/79 


C12). >CR 


(11) FACTORY COSTS 
ADMINISTRATIVE COSTS 
TQ PRODUCE 4005000.00 
TO ZNGAGE SECOND SHIFT 1502000.00 
MAINTENANCE COST PER MACHINE 250-00 
PROOUCTION COST 
PRODUCT A 800.00 
MATERTAL 800-00 
MACHINE HOURS 200.00 
MAN HOURS 200.00 
LABOR COST 
FIRST SHIFT (PER MAN HOUR) 5.200 
SECOND SHIFT 3045 
NUMBER O= MACHINES AVAILABLE 450.00 


(12) >CR 
(11) If the table had been specified as a "Floating Keep", this 
text would have been printed on the page oreceding the table! 


(13) This passage will appear in the formatted output following 
the text from the inserted file. 


(14) This example was concluded on 
(15) AUGUST 24,¢, 1978 at 13228226. 
(165) > 


EXPLANATIONS FOR EXAMPLE 6 


(1) DELET.. 1= 


This command deletes all text and formatting requests’ that 
were entered as part of Example 5. 


(2) APPEND 


This command tells OS/32 TEXT to accept and remember the text 
and formatting requests that you are about to entere 
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(4) 


(5) 


(7) 


(3) 


(10) 


{11) 


C12) 


»IMBED EXAMPLES5-RVO 

This formatting request specifies that the text to be 
formatted is contained in the file EXAMPLE5.~RVO. The file 
contains text and formatting requests. The text (from the 
file is inserted after Line 8 of Example Ge then all text 
from the file has been formatteds processing continues with 
Line 11 of Example 6. 

eBREAK 

This formatting request is only effective if filling output 
Lines is specified (eFILL). Heres a "break" occurs in the 
filling of Lines at the end of the text on tine 15 and a new 
output Line ts startede 

eMONTH 


This request inserts the current month into the output text 
streame The months are spelled out3 @egee JANUARY. 


eDAY 9 

This request inserts the day of the month into the output 
text streame The comma ts onottonal and is added to the date 
for punctuatione 


«YEAR 


This request inserts the year (@ege 1978) into the output 
text streame 


eTIME eo 

This request inserts the current time into the output text 
streame The second period is optional and is added to the 
time display for punctuatione 

FORMAT HALT 

You tell OS/32 TEXT to produce the formatted output of the 
text in Example 66 Formatting will be halted at the 
ceginning of each page until you depress RETURN to continue. 


In this example.eesentence 


This is the formatted text from Lines 2-6 that you entered in 
Example 66 


This exampleeeepreceding the table! 
This text was inserted from file EXAMPLES5S-eRVO.~ 
CR 


Continue with formatted output of next page. 
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(15) 


(14) 


(15) 


(16) 


This passSageeee inserted file 


This is the text from Lines i1 and 12 that 


Fxample Ge 


This exampleeeeon 


This Line is affected by the BREAK request. 
Line was output after the word "on". 


AUGUST eeel3:228:2 266 


This Line is the result 
requestSe 


> 


No more pages to output. 
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o f the date and 


O0S$/32 TEXT returns 


you entered in 


Note that a new 


time formatting 


to command mode. 
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CHAPTER 4% 
GUIDE TO USING OS/32 TEXT FEATURES 


This chapter describes the functions that OS/32 TEXT 
performse The commands and formatting requests used to 
oroduce a document are introduced according to their function 
in the preparation of a document. The commands and 
formatting requests are described in detail in Chapters 5 and 
6e respectively. 


The sections below discuss: 


o terms which are frequently used throughout this manual 
o functions performed by OS/32 TEXT commands 
o preparing text to be formatted 


o file handling 


4e1 TERMINOLOGY 


Throughout the manual the following words have special 
meanings: | 


Oo TEXT and OS/32 TEXT 


TEXT and OS/32 TEXT are used interchangeaoly to refer to 
the proaram whose operation and use is described in this 
manual. 


o Commana 


A command is a directive to the program to perform a 
certain functione For examplee the words LOAD and START 
are commands to the Operating Systeme Whenever TEXT 
displays the > symbol, it expects you to enter a command 
to tell the program what to dow TYPEs APPEND» INSERT, 
FORMAT» e2@tCee are OS/32 TEXT commandse Each OS/32 TEXT 
command is described tn Chapter 5. 
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o Command Mode 


When TEXT expects you to enter a commands the prompt 
symbol (>) ds displayeds and the program is said to be 
in the command modee Some commands perform a_e function 
and then return the program to the command modee GET» 
TYPEs and SAVE are such commandse Other commands switch 
the program to text mode (see below). 


Text Mode 


When you enter an APPEND» INSERT» or REPLACE command, 
OS/32 TEXT switches to text modee In this modes the 
orogram retains for future processing whatever is typed 
on the keyboard. In text mode Lines of text and 
formatting requests can be entered. Text mode remains 
in effect until you switch back to command modee This 
fs done by depressing the RETURN key as the first entry 
on a new lLinee 


Formatting Request 


A formatting request is a directive which describes to 
TEXT the desired appearance of the document being 
producede A formatting request is entered in text mode 
together with the document texte eMARGINe »ePARAGRAPHe 
and eSKIP are examples of formatting requests. 


A formatting request nust always be entered on a Line by 
jtself and must appear at the beginning of that line. 
A formatting requests consists of a control characters 
a directives and in some cases an arguments @eges eSKIP 
29 where the period is the control character. 


The control character which is initially in effect and 
js generally useds is the periode However, it is 
possible to redefine the control character with the 
eCONTROL formatting requeste You may want to change the 
control character if you have a text Line beginning with 
the current control character. 


Formatting requests are interpreted by OS/32 TEXT when 
the FORMAT command is enterede This command is used to 
produce formatted output (see below) of your document. 


Many formatting requests have initial value settings. 
These values are in effect each time the FORMAT command 
4#s executed. These values can be replaced by the values 
specified in the formatting requests appearing in the 
text. 


Chapter 6 describes the formatting requests and contains 
a table of formatting request initial values. 
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0 Document Text and Raw Text 


These terms are used interchangeably to refer to the 
wordse sentenceS, etce which comprise the body of the 
document you are oproducings exclusive of formatting 
requests. 


o Text 


Text usually refers to both document text and formatting 
requestsSe In some cases the word text refers to fraw 
text onlye In these cases the meaning of text should be 
clear from the contexte 


o Formatted Output 


The term formatted output refers to the final form of 
the document you are preparinge The text which you have 
entered aopears in the form you have specified usina 
formatting requests. Formatted outpdut can only be 
produced by entering the FORMAT commande 


4e2 EXPLANATION OF COMMAND USAGE 


The. following sections describe the functions that O0S/32 TEXT 
performs and the commands you would use to perform these 
functions. The commands are described in detail in Chapter 
Se 


G%e2el Entering Text 


The APPEND command fis used to enter text to be processed. 
APPEND allows you to enter text when you are just starting to 
preoare anew document or to add text at the end of existing 
texte 


When entering text, it is important that you remember the 
following? 


o The Last character on one Line and the first character 
on the next Line are treated as separate words. This 
means that you do not have to type a space to separate 
these wordSe 


Oo For the same reason» cdo not hyphenate a word at trie and 
o f a Line the way you would on a typewriter. 
Hyphenation requires special consideration. Please 
refer to the description of the eHYPHENATE formatting 
request in Chapter 6 for additional information. 
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Ge2e2 Reviewing Text 


After you have entered and modified texts you may want to 
review ite The TYPE command tells TEXT to display on the 
List device the text you have entered. If necessarys you can 
change the List device by using the OPTION command to specify 
a different List device (e@eges printer) for your reviewe 


e.2e35 Modifying Text 


To facilitate the correction of errors and text revisions a 
number of OS/32 TEXT commands are available: 


Oo FIND 


This command searches the text Lines for a specified 
character string. Text Lines containing a match are 
displayed. 


Oo CHANGE 


This command modifies text Lines reolacing a specified 
character string with a new onee The text iS searched 
for a match of the specifted character string. Each 
time a match is founds the Line is modified and the 
resulting Line is displayede 


Oo INSERT 
This command allows you to insert text following a 
specified text Linee The inserted text may consist of 
one or more Linese 

o INCLUDE 
This command is a powerful variation of the INSERT 
commande It allows yaoau to copy one or more text Lines 
and insert them following a soecified text line. The 
Lines to be copied nay be part of: 


- the text currently being processed by 
OS/32 TEXTe or 


- the text stored ina disc file. 
o DELETE 


This command deletes one or more text Lines. 
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4e204 Saving Text 


The text that you entered can be saved in a disc file for 
future processinge The SAVE command creates a file using a 
file name that you specify and copies the text to this file. 


OS/32 TEXT issues a warning message if you try to save text 
into an existing file. This its done to protect you from 
inadvertently destroying what may be a master filee It is 
possible to override this warning and save your text into an 
existing file. 


4e225 Retrieving Text 


Text that was stored in a disc file using the SAVE command 
can be retrieved using the GET commande The GET command 
copies the text from a specified file and makes it available 
to you as if you had just entered it from the keyboarde 


42.266 Producing Formatted Text 


To obtain the formatted output of the text which you have 
entered»s you use the FORMAT commande This command produces 
the formatted output according to the formatting requests 
specified with the document text. 


Refore you can use the FORMAT commande the text to  obe 
formatted must be made available to oOS/32 TEXT for 
formattinge This is done by either entering the text from 
the keyboard or using the GET command to retrieve the text 
that was previously entered and stored ina dise file. 
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The FORMAT command provides options to: 


o select the device where the formatted output should = go 
(@eGee printers, Carousels CRT» disc filed. 


o select the formatted pages to be printed (@eges page ls 
pages 3-5, all pages). 


o halt printing at tne beginning of each page to allow 
changing papers until directed to continue. 


o output across reference listing that relates the text 
on the formatted pages to the Line numbders of tne text 
Lines that you entered. 


An imoortant point to note is that the formatted outputs iif 
directed to a dise file, cannot be subsequently modified. 
The file can only be processed by the GET command and then 
the PRINT command to print the formatted document an a 
specified devicee 


Se2e7 Use of Cross Reference Line Numbers 


The FORMAT command allows you to request a cross”) reference 
Listing that relates the text on the formatted output pages 
to the raw input text Lines of a documente The purpose of 
this Listing is to aid you in making document text revisionse 


The Listing is generated following the formatted output of a 
documente Tt lists the Line numbers for the first and last 
raw text Lines that appear on each Ppagee The Line numbers 
correspond to the numbers assigned to these Lines by TEXT 
during the editing process. They can therefore be used to 
easily locate the raw text lines for each formatted page. 
Notes howevers that when the text being formatted contains 
fractional line numbers (e@ege 1l1e0ls Sed7y ette)ds It should 
first be SAVEd in a file and then retrieved with the GET 
commande This procedure will renumber the raw text Lines and 
Synchronize them with the Line numbers itn the cross reference 
Listing. 
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4e2e¢8 Producing Copies of Formatted Text 


If the formatted output of your text was directed to a disc 
files you can use the PRINT command to nake a copy of the 
file contents. 


The PRINT command allows you to specify the output device 
where the file is to be printed. 


Before you can use the PRINT commandy the file to be 
processed must be made available to OS/22 TEXT via the GET 
commande 


4e3 FORMATTING REQUEST USAGE 


The following sections describe the formatting capabilities 
of OS/32 TEXT and the appropriate formatting requests to use 
when preparing a documente 


4.3.1 Page Setup 


The formatting requests in this group define the physical 
page size and text area for the formatted output. 


Gexselel Standard Page Layout 


To obtain the formatted output of the documents, the size and 
margins of the page that will contain the formatted document 
text nust pe aefinede 


OS/32 TEXT provides standard (default) page layout for paper 
size 8 i/2 inches dy il inchese If this Layout is not 
suitable for your needS» you can modify it by including the 
aoorooriate formatting requests in your texte. Figure 4-1 
shows the standard page Layout used by OS/32 TEXT. 
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The outer rectangle of asterisks in the diagram outlines’ the 
physical dimensions of a sheet of paper. The inner rectangle 
of asterisks represents the text area: that part of the 
Physical page into which OS/32 TEXT formats the document 
texte 
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Figure 4-1 Standard Page Layout 
(Paper Size 8-1/2 inches by 11 inches) 


The Standard Page Layout has the following tnitial values for 
the formatting requests shown in the diagram: 


MA 12074 (Left Margin = 12) eLW 85 (Line Width) 
(Right Margin = 74) oPL 66 (Page Length) 

oT™ 5 (Top Margin) 

03M 5 (Bottom Margin) 
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Ge5ele2 Line Width 


The LWIOTH formatting request specifies the physical width of 
the page that contains the formatted document. The Line 
width is expressed in the number of character positions that 
fit across the page that you would be using. 


4esele3 Page Length 


The ePLENGTH formatting request specifies the physical Length 
of the page that will contain the formatted document. The 
page length is the number of Lines available on one page of 
the output document. 


Gersele4 Left and Right Margin 


The eMARGIN formatting request sets the asdsoltute left and 
right margins of a pagee The margins are the available 
character positions on the physical pages counted from left 
to right. 


The ePARAGRAPH and .INDENT formatting requests permit 
indenting and outdenting of the next Line of text from the 
Left margine 


Ge5ele5 Top and Bottom Margin 


The eTMARGIN and .8MARGIN formatting requests define the 
number of olank Lines to occur at the top and bottom of each 
Dagee 


Too and bottom page titles, if soecifieds appear within these 
marginse 


27-677 ROO: 2779 4=9 


GeseleG Left and Right Margin Temporary Offsets 


The eL MARGIN and eR MARGIN formatting requests make 
adjustments to the Left and right margin settings currently 
in effect. Each margin can be adjusted to the left or to the 
righte 


The reset feature of these formatting requests returns” the 
margins to the settings which were in effect prior to the 
current adjustment. Multiple adjustments/resets are 
permitted. 


Gese2 Text Line Processing 


Formatting requests in this group control the conversion of 
raw text Lines» which the user enters, to formatted output 
LineSe 


e5e2el1 Line Filling 


Unless the user specifies otherwises the following formatting 
requests are in effect when TEXT 8S preparing formatted 
output: 


o eFILL - fill output Lines as specified by 
justification requests 


o eL JUSTIFY ON =- Left justify output Lines 
Oo eRJUSTIFY ON = right justify output lines 
These formatting requests cause words from the text that the 


user enters to be Linked together into an output Line until 
a word does not fite (The word that does not fit becomes the 


first word of the next output Line.) If necessarye the 
current line iis then "justified" by inserting blank spaces 
between words so that the Line touches both margins. When 


forming the output Lines Leading spaces and multiple spaces 
hetween words in the raw text are ignorede The placement of 
words into output Lines may be optimized by defining word 
syllables in the raw text using the eHYPHENATE formatting 
requeste 
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Certain formatting requests interrupt or "break" the 
stringing together of wordse For examples a break occurs 
when starting a new paragraphe A break is also caused by a 
completely blank Line in the raw texte A blank Line appears 
in the formatted output (unless it occurs tn ae footnote). 
Formatting requests that cause a break are jidentified in 
Chaoter 6 and in the formatting request summary in Adpendix 
Ae 


The preceding paragraphs described the effect of eFILL with 
both eLJUSTIFY and .eRJUSTIFY ONe The effect of eFILL with 
the Latter two formatting requests in their various ON/OFF 
combinations is summarized as follows: 


O eLJUSTIFY ON 
0 eRJUSTIFY OFF 


Lines of output text are aligned at the Left margin. 
Words are placed in the Line until a word does not 
fite but no additional spaces are insert2d odetween 
wordSe 


Oo eLJUSTIFY OFF 
O eRJUSTI-Y OFF 


Text Lines are output as if Left justification only 
were in effect. 


Oo eL JUSTIFY OFF 
O eRJUSTIFY ON 


Output text is aligned at the right margin. No 
additional spaces are inserted between words. 


Oo eL JUSTIFY ON 
O eRJUSTIFY ON 


Lines of output text are aligned at both the left and 
right margins. Words are placed in the Line until a 
word does not fits; additional spaces are tnserted 
between words to cause margin alignment. 
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> 


Gese2ee Sentence Terminators 


The following punctuation characters are considered sentence 
terminators: 


These characters are only considered sentence terminators 
when they appear at the end of a worde If one of these 
characters appears in the niddle of a word it is treated as 
part of the word itself.’ 


Sentence terminators are always followed by two spaces in the 
fornatted output Linese A brace and closing parentheses are 
also followed by two spaces if the character immediately 
oreceding them is a sentence terminatore 


ALL other punctuation characters are followed dy one space 
onlye 


Punctuation characters and non-alphabetic characters are 
considered part of the word they appear with in the raw texte 
unless the characters are separated by blank spaces from the 
preceding worde In that cas@y they may become separated from 
the word and not even appear on the same output text line as 
the worde For exanple: 


CHARACTERS 
Part of a word 
ende end e 
ends end » 
(end) ( end ) 
fend" 90 end at 


The formatting request eBLANK can be used to override the 
implicit double spacing after a sentence terminator. 
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GeSe2e3 Centering Text 


The ecENTER formatting request is used to center text Lines 
between the Left and right margin settingse Raw text lines 
are centered "as is" in the formatted output. Stringing 
together of Lines and elimination of extra spaces between ~ 
words is not performed. 


4.34264 Paragraphs 


The ePARAGRAPH formatting request causes the start of a new 
Paragraph in the formatted output texte PARAGRAPH also 
performs optional in/outdenting of the first line in the 
paragraphe : 


4$e.3-e2-¢5 Indenting 
The eINDENT formatting request is used to indent or outdent 
abline relative to the current setting of the left margin. 


4e5e206 Spacing and Skipping Lines 


The eSPACE formatting request specifies the Line spacing to 
be in effect in the formatted output. For examples eSPACE 2 
specifies double spacing is to be in effecte 


eSKIP outputs one or more olank Lines directly following the 
eSKIP requeste 
40323 Table Handling 


This section provides information about building and 
formatting of document text in table form. It may be helpful 
to review Example 5 in Chapter 3 which addresses the subject 
of taole handling. 
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Ge5e5e1 Tadulation 


OS/32 TEXT provides the capability to set tabulation stops 
which are recognized and adhered to during text entry and 
formatted outpute 


To produce formatted output of text in table form you specify 
the .NOFILL formatting request. This request suspends 
stringing words together in the output Lines and does not 
remove multiple spaces between words in the raw text. It is 
your responsibility to arrange the table Layout when the raw 
text for the tabdle is entered. 


The effect of eNOFILL with eLJUSTIFY and eRJUSTIFY ON or OFF 
on the formatted output is as follows: whenever left 
justification is in effects Lines of output text are 
positioned at the Left margins if only right justification is 
in effects Lines of output text are aligned at the right 
margins if neither left nor right justification is in effects 
Lines are positioned at the left margin. 


GeseSe2 Placement 


A table can be placed in two different ways in the formatted 
output of a documente using etther the eBLOCK or the eKEEP 
formatting request. The e3LOCK request causes the table to 
ce output where it appears in the raw texte When using the 
oXEFEP requests text Lines that follow the table in the raw 
Text may appear pefore the table in the formatted outpute 


4.324 Page HeadingsSs Footingss and Numbers 


The formatting requests in this group control page Labeling 
and numberinags and the processing of footnotese 


Ge34421 Top and Bottom Page Titles 


The formatting requests .eTTITLE and e.8TITLE are used to 
cefine top and bottom page titles respectivelye which are 
useda during the formatting processe The specified titles 
aooear on each output page in the areas defined as top and 
pottom page marginse If 2@ page number symool is part of a 
titles the output pages are automatically numbered. 
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Bere4e2 Even-0dd Page Titles 


The formatting requests eEVENTOP»s eODDTOP» eEVENBOTTOMs and 
eODDBOTTOMs perform the same functions as eTTITLE and eBTITLE 
described above» except that they allow different titles to 
appear on odd and even numoered pageSe 


4Gese4e3 Automatic Page Numbers 


The ePNUMBER formatting request is used to set the automatic 
page numbering. This request defines the initial page 
numbers the page number increment and a special page number 
symbol. When this symbol appears ina page title, it is 
reolaced by the computed page number in the formatted output 
of a documente 


be 30404 Footnotes 


The text of a footnote ts defined by the eFOOTNOTE formatting 
requeste The text for the footnote should be entered 
immediately following the Line that references ity», so that it 
may apoear at the »pottom of the page containing the 
referenceée 


4.325 Document Revision Identification 


when a document is revisede changes in the raw text can be 
identified using the -BAR formatting request in conjuction 
with the -eRLEVEL formatting request. When producing the 
formatted output of revised document,» revised areas are 
marked with revision pars. 


The revision bars normally appear in the right margin unless 
OOD/EVEN page titles are specified. If ODD/EVEN page titles 
are specified, the bars aprear in the right margin on odd 
numbered pages and in the Left margin on even numbered pagese 
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The eBAR formatting request is used to define the modified 
text and revision Level number when changes to a document are 
enterede For each subsequent revision of a ‘document the user 
can inerement the level number. The eRLEVEL formatting 
request soecifies which revision level should be recognized 
so that the corresponding text is marked when producing the 
formatted output of the documente If eRLEVEL is not 
specifiede the formatted output is not marked with barse 


G§e5e6 User Control During Formatting 


This section describes features that aid in maintaining text 
and producing the formatted output of a document. 


GedeGbel RETURN 


Ourtng processing of the FORMAT commande you can direct TEXT 
to temporarily read text that you will enter at the command 
jnout devicee The RETURN formatting request is used to do 
thise The text that you enter becomes part of the formatted 
outpute This feature may be usede for examples when 
Preoaring form tLetterss to insert a different address in each 
Lettere 


Coticnally, eRETURN can display a comment on the command 
ingut device to promot you on the type of text to entere 


When eRETURN Js used, the device for the formatted output 
cannot be the same as the command input device. If you have 
no alternativess direct the formatted output to a disc file 
and use the PRINT command to obtain copies of the formatted 
outout e 


$e35eSe2 QUIT 


When OS/32 TEXT is creating the formatted output of a 
dacuments tne formatting process may be terminated via the 
eQUIT formatting requeste The effect of eQUIT depends on 
where it 4s encountered during the formatting processe The 
formatting requests eIMBEDs and eRETURNes and the command 
FORMAT are affected by eQUIT.e 
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4e3e6035 COMMENT 


The eCOMMENT request allows you to insert comments throughout 
the raw text of a document to keep notes for your own use 
concerning the preparatione maintenances and formatting 
requirements of a particular document. 


The eCOMMENT formatting request has no effect on the 
appearance of the formatted document. When producing the 
formatted outputs it is ignored. 


4eo3e6e%4% Prompt Suppression 


MTM displays a dash "-" prompt when OS/32 TEXT performs 
Input/Output operations to an MTM terminal (CRTe Carousels 
etce)e If you are using the terminal (e@ege Carousel) to 
produce the final formatted versions of a documents the 
display of this prompt is generally undesirable. 


The following OS/22 MTM commands allow you to control the 
display of the prompt: 


ENABLE PROMPT 
PREVENT PROMPT 


Since these are MTM system commands, they can only be issuec. 
in the MTM System Command Input Mode which is indicated by 
the display of a "*", 


Normallye you would enter these commands before you load or 
start OS/32 TEXTe If you have already started OS/32 TEXT you 
can use the following orocedure to enter the ENABLE or 
PREVENT commandse 


Assume that you want to disable the prompt: (0S/32 TEXT must 
be in the command input mode.) 
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USER/MTM DIALOGUE EXPLANATION 


>PAUSE Pause 0S/32 TEXT to gaitn MTM 
command mode 

*TASK PAUSED OS$/32 TEXT 4s paused and 
MTM awaits command 

*PREVENT PROMPT Jisable display of - 

*CONTINUE Continue operation of OS/32 TEXT 

> OS/32 TEXT awaits commands 
note that the - is no Longer 
displayed. 

if executing TEXT at the system consoles the task 


jdentification displayed on the system console device cannot 
pe sunppressede 


It. is therefore not practical to use the console device to 
oroduce a formatted output of a documente The output should 
be directed to a printer or another terminal on the system. 


4e353e60e5 Changing Paper 


The HALT operand of the FORMAT command provides the 
capability to suspend output of formatted text at the 
beginning of each page. 


This capability allows you to change or position the paper in 
a orinting device if the paper has to be inserted manually 
for each pagee To resume producing formatted outout after a 
halte deoress the RETURN key. 


Please note that if the formatted output is directed to a 
disc file and then printed via the PRINT commands printing 
cannot be suspended after each page. 
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Ge3e7 Use of the Imbed Formatting Request 


The eIMBED formatting request is a powerful feature of 08/32 
TEXT « whem producing the formatted output of a documents 
eIMBED tells TEXT to switch to a different file to obtain 
text to be formatted. The text in the file specified in the 
eIMBED request is formatted and merged into the document 
being formatted. The file being switched to may itself 
contain an eIMBED request for yet another files and so on up 
to a Level of ten filese 


Formatting an imbedded file is terminated when an end-of-file 
or the eQUIT formatting request ts encountered. Formatting 
continuess using the text that contained the .IMBED request. 


Normally» the eIMBED request specifies a dise file as the 
input file. Howevere the command input device can 0obe 
specifiede The information contained in ae fike to be 
imbedded may consist of raw text onlys formatting requests 
onlye or a combination of these twoe 


GerxelTeol Merging Text 


Merging text from different files into a single document is 
one of the most common apolications of the eIMBED formatting 
requeste When producing a manual such as this ones each 
chapter or section can be maintained in a separate file. 
When it is necessary to produce the formatted output of the 
entire documents the chapters are combined into a single 
document by building a file which contains .IMB8E9D requests 
for each individual file. 


GeseTe2 Predefined Sets of Formatting Requests 


Another apolication of -IMBED is to specify a file which 
consists completely of formatting requestse For examples you 
could define a standard page Layouts spacing and title for a 
particular document (@eGee company memod-se and save the 
formatting requests in a file» When you want to produce a 
formatted output of the documents you simoly imbed this file 
instead of entering all the formatting requests each time 
with the document text. 
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Of course there are many more applications besides the ones 
mentioned heree In generals if you find yourself typing a 
series of formatting requests or text (@egee copyright 
statements distribution List) repeatedly,» store these items 
ina file and insert them as necessary using the eIMBED 
formatting request. 


4e4 FILE HANDLING 


A file is a collection of data stored on a dise deviceée The 
storeq data can be retrieved whenever it is needed for 
processinge Files remain on the dise until they are 


exolicitly removede 
Tne following aspects of file handling are considered when 
using TEXTS: 

o0 naming a file in which to store texts 

o 6©6specifying a file from which to retrieve texts 

0 displaying names of existing files; 


o deteting obsolete files. 


4,%e¢1 Naming a File 


Naming a file to be used to store text is done when using the 
SAVE and FORMAT commands. These commands create a file from 
a specified nane and output text to that file. 


Chapter 5 explains the format of the file descriptor operand 


(fd) which is used in these commands to specify a file name. 


4.4.22 Specifying a File Nane to Retrieve Text 


The GET command is used to retrieve text from ae file 
previously specified in the SAVE or FORMAT command. The 
rules for specitying a file name are the sane as for naming 
a file and are described in Chapter 5. 
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4.2.4.3 Displaying File Names 


At timese you may want to review the various files which you 
have created using TEXT. 


The Operating System command DISPLAY FILE is used to display 
the names of existing filese To use the commande the System 
must be in comnand input modee as indicated by the display of 
an asterisk "*",. Normally» you would use the command before 
starting or after terminating the execution of TEXT. 


Howevers it is possible to temoorarily halt the execution of 
TEXT using the PAUSE command to switch control to the 
Operating System command input mode. You can then review 
your files. For additoral information refer to the MTM 
Terminal User'ts Reference Manual or the 0S$/32 MT Operator's 
Reference Manuale 


404-4 Deleting Files 


The Operating System command CELETE ts used to remove’ fites 
that are no longer needede 


The general format of the command is: 
DELETE fd 

wheres 
fd = the file descriptor identifying 


the file to be deleted. 


The use of fd 4s described in Chapter 5. For additional 
information refer to the MTM Terminal User®*s Reference Manual 
or the O0S/32 MT Operator’s Reference Manual. 
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SS 0 


CHAPTER 5 
COMMAND DESCRIPTIONS 


Sel INTRODUCTION 


This section describes the use of O0S/32 TEXT commandse The 
general usage of O0S/32 TEXT commands is explained in Chapter 
4. 


Section 5e2 describes the command syntaxe Section 563 
contains descriptions of each command. The descriptions are 
oresented in alphabdetical order. 


Se2 SYNTAX 


This section describes the syntax used to specify aie TEXT 
commande 


Sel2el Command Format 


The general format of a TEXT command is as follows: 
MNEMONIC gperand] sgperand2 eee 
wheres 


MNEMONIC specifies a TEXT commande The underlined part 
of the mnemonic is the minimum abbreviation acceptaole 
for that commande The mnemonic must be separated (from 
its first operand by at least one blank. 


The underlined portion of an operand refers to the 
minimum abbreviation of a keyword operand. Operands are 
separated by commase 


TEXT commandse and operands which do not explicitly 
reference text stringss may be entered in upper or lower 
case letters. 
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5 e202 ODerand Formats 


This section describes the various forms of operands that may 
be specified to reference text Linese The operand symbols 
Given in the following sections are used in the command 
descrioations to indicate which operands may be used with a 
specific commande 


Se2e2e1 String Operand 
Symbol: § 
A string coerand specifies a text Line by a sequence of one 
orp more ASCII characters = including olanks. 
The string operand may be one of the following forms: 
o delimiter S delimiter 
o delimiter S$ delimiter column 
wheres 
"delimiter" is a nonw-alphanumeric character except a 
commas ninus signs ar blank. The delimiter may not be 
part of the string it defines. 
"column" Ys an integer specifying that the string is 
only valid for that character position in a text Line. 


Matching strings that do not start in the specified 
column are ignorede 


EXAMPLES OF STRING OPERANDS: 
le eEX AMPLE © 


specifies a string of seven characterse The period is 
used as tne dalimiter. 


Ze /used/4 
specifies a string of four characters. The string is 


defined only for column 4 of the Line of text being 
searchede 
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fe 


Se2e2e2 Line Number 

Symbol: Line Number 
A Line number operand specifies a text Line by its assigned 
Number e The specified line number may be one of the « 
following forms: 

a) integer 

b) Integer.decimal 


wheres 


O¢integer¢99999 
O¢decimal<¢g99 


EXAMPLES OF LINE NUMBER OPERANOS: 
1. Valid Line numbers: 


52 
1 
99999 
7099 
426-00 
1400.7 
0625 


2e Invalid Line numbers: 


62839 too many decimal places 


100000 integer too Larges maximum ts 399599 
Ze missing decimal digit 
-615 negative numbers, illegal 
4 missing integer part 


5 e2e2235 L Aperand 


Symbols L 


The L operand specifies that text lines may be referenced 


either by a string or by a Line number as described above. 


5S el2et2e 4 Range Aperand 
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Symbols R 


The range 
from-to) 
the range 


The Lines 
which qs 
R operand 


R 


ted 


i 


Li 


=L2 


{olank) 


x*The dash 


ooerand specifies a range of text Lines (Tees 
which are to be processed by the command containing 
operande 


referenced by R are specified by the tL operands 
either a Line number or a string operand (S)e The 
may have the following forms; 


Descriotion 


Linel only 


Linel thru Line2 
inclusive 


Linel thru last 
Line of text 


Current Line thru 
Line2e 


Omitting the Range operands imolies 
current Line only except for the SAVE 
commande where, If no Range is givens 
all Lines of text are processede 


Current line through Last line of texte 


(-) is uSed aS a range argument Separatore 


FXAMPLES OF RANGE OPERANDS: 


Range Type Description 
1-20 LL=t2 Lines numbered 1 through 
Line 20 including all 
fractional (esge 1-20192.10) 
Lines in between 
alLAeteENDnw Li-L2 Line containing string 
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LA through Line containing 
string ENDe inclusive 


Ber—-eRETURNe - LieL2 Line numbered 8.3 through 
Line containing RETURN 
inclusive 


73 Li Only Line numbered 73 


eas is.10 Li Only Line containing string 
"as is" beginning in 
column 10 


Sel2e2e5 File Descriptor Operand 


Symool: fd 


The operand symbol fd refers to a file descriptor in standard 
0S/32 and O0S/32 MTM formate The fd may specify a device or 
a file ona mass storage device. 


The general format of fd has the following parameters: 


voln:filenameeext/efd 
voln: 


The volume name is composed of one to four alphanumeric 
characters, terminated by a colon. The first character must 
be alphabetic. This is the name of the volume on which the 
file residese If the volume name is omitted, the default 
volume name is assumed. 


The default volume can be set with the VOLUME system command. 
For a description of this command, see the appropriate 
reference manual for your system as Listed in the Preface of 
this manual. 


When fd refers to a devices the VOLN field is used to contain 
the device mnemonice The device mnemonic can be from dne_ to 
four characters long and is terminated by a colone A 
filename and extension, if enteredse are ignored. 


filename 


29-677 ROO 2/79 5-5 


The filename consists of one to eight alphanumeric characters 
where the first character must be alphabetice This is the 
identifier for the file and may be anything the user choseSe 


® 
om 
x 
ct 


The extension consists of a period followed by one to three 
alphanumeric characterse The extension may be omitted 
entirely, or just the pericd givens in: which case the 
extension is considered to consist of blankse The extension 
can be used to denote the contents of the file such as type 
of datas revision levels etce 


~ 
mo 

—h 
Q. 


The optional extended file descriptor is recognized by MIM 
onlye The efd can be Ps Ge or Se which stand for Privates 
Groups or System file respectively. If the extended field is 
not givens the default is ®, for Private. 


EXAMPLES OF FD OPERANDS 


td voln: filename 2X /efd 
MZQOQSFILEeRVO M300° FILE eRVO Private file 
by default 
TXAMPLE e1/G default volume EXAMPLE el Group File 
STOMEMO default volumes STOME MO (blank) Private file 
by default by default 
(b=blank) 
M6E7ASF12345857/6 MS7AS F1234567 (blank) Group File 
PRS devicesprinter N/A N/A N/A 
CONS cevicesconsole N/A N/A N/A 


5Se3 OESCRIPTION OF TEXT COMMANDS 


This section describes OS/32 TEXT commandse The commands are 
oresented in alphabetical order. 
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With the exceotion of FORMAT and PRINT« these commands are 
based on the capability provided by the O0S/32 EDIT program. 
You may refer to the OS/32 User's Guide to supplement the 
information provided tn this section. 


Most command descriotions are illustrated with examoles. It 
is imolied that the commands and text that the user inouts in 
these examples are always terminated by depressing the RETURN 
keye In the examples CR is used when the user should depress 
RETURN as the only entry on the given Linee 


The command descriotions also refer to the TEXT concepts of 
"Line Numbers" and "Current Line" which are defined here. 


0 Line Numbers 


Line numbers are a convenient mechanism for 
fdentifying text lLinese The Line numbers can pe used 
by most TEXT commands to reference text for editing 
functionse 


The Line numbers are automatically assigned when a 
file is opened for editingse or are generated when text 
is entered from the command input devicee Each line 
retains its assigned number as long as the Line exists 
during the text processing session. Line numbers are 
output only when text is displayed. They are not 
written to the output filee 


Line numbers are assigned starting with numser 1 and 
are incremented by one up to a maximum of 99999. 


Fractional Line numders are assigned when text is 
inserted between integer Line numbers. They are 
generated by incrementing the Line number, which 
precedes the inserted texte by eOle The Line number 
of each inserted line is e01 greater than tne previous 
Linee Inerementing stoops if anew line nunber would 
equal an existing Line number. Thus» several Lines 
may exist with the same Line number. Text may be 
renumbered by saving the text to a file and then 
retrieving it again (see SAVE and GET commands). 


o Current Line 


TEXT maintains a “current tine" during orocessing.e 
The current Line ts defined as the result of 
performing a TEXT command. Most TEXT commands can 


perform their operation on the current Line as the 
default casee A comand may also specify any Line 
which is not the current tine and thus change the 
current Line. The command descriptions give the 
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Ww 
( 
~J 


status of 
executione 


the 


current 


Line 


at 


the end of command 
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5 e321 APPEND Command 


Mnemonic: | APPEND 

Operands: None ue 

Descriotion: AltLows user to enter text from the command 
input devices Line numbers and a ">" symbol 


are output 3s prompts to the usere Oepressing 
RETURN directly after the prompt is given 
terminates text entry and returns TEXT to 
command modee If no text currently existse 
the new text starts with Line number one (1). 
If text currently exists, naw Lines are added 
to the end of the exitsting text. 


Current Line: Last Line of text entered. 


EXAMPLES? 
Example 1: 
No Existing Text: 


Fnater command: >A 


TEXT prompts: EL >XYZ User enters: 
XYZ 
TEXT oromots: 2 >ASBC User enters: 
A8C 
TEXT promotss 3 NO MORE User enters: 
NO MORE 
TEXT prompts: 4 >CR User enters: 
Carriage Return 
Resulting text: 1 XYZ 
Be ABC 
3 NO MORE Current Line 


Example 2: 


Existing text: PACE Current Line 


i 

2 Is 
2e30 ASCII TYPE 
Enter Command: >A 


TEXT oromptss: 3 >TODAY User enters: 
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Resulting text: 


4 DCR 


ASCII TYPE 
TODAY 


TODAY 

User enters: 
Carriage 
Return 


Current Line 
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5-322 CHANGE Command 


Mnemonic: 


Operands: 


Description: 


Current Lines: 


EXAMPLES: 
Example 13° 
Change "was" to 


Existing text: 


Enter commands 


Resulting text: 


Fxample 23 


CHANGE 

S1¢eS29R Si=Stringl 
S2=String2 
R=Range 


This command replaces every occurrence of 
string Si with string S2 in the range Re 


Sl specifies the string to be replaced while 
S2 defines the new stringe S2 may specify an 
empty stringe ALL changed text lines are 
output to the list device so that the user can 
verify the change. See OPTION VERIFY. 


Last Line of Range. 


nist in Line le 


1 *This was an example Current Line 
2 x*how to use the the 
3 *CHANGE command. 


>CH/was/e/is/l 


«This ts an example Current Line 
*how to use the the 
*CHANGE commande 


GW fo ke 


Celete superfluous "the" in Line 2 


starting at cha 
Enter command: 


Resulting text: 


Example 33 
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racter position 17. 


PCH etheel7e//oe2 


1 *This is an example 
2 *how to use the Current Line 
3 *CHIANGE commande 


Change "*" to *!1" fn all text Linese 


Enter command: oOCH/*/geleal@= 


Resulting text: 1 'This is an example 
2 thow to use the 
3 (CHANGE commande Current Line «~ 
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5S e3e3 Change COLUMN Command 


Mnemonic: COLUMN 
Operands: CeaSeR C=Column 

S=String 

R=Range 
Descriotion: The current contents of each Line in the range 


R are overwritten beginning at the column 
specified oy Ce» with the string specified by 
Se When the COLUMN command is executeds 
changed text lines are output to the List 
device so that the user can verify the change. 
See OPTION VERIFY. 


Current Line: Last Line of Range. 


EXAMPLES: 
Example 1° 
Change column 9 in Line le. 


Fxisting text: 1 ASCDEFG 11234 Current Line 
2 ABSCDEFG 56789 


Enter command: >C0O 9e/0/oel 

Resulting texts 1 ABCDEFG 01234 Current Line 
2 ABCDEFG 56789 

Example 238 

Change columns 1-3 in all Lines. 

Enter command: CO le/XY2Z/qli- 


Resulting text: 1 XYZEFG 01234 
2 XYZEFG 56789 Current Line 
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Se 5 e4)= 6DELETE Command 


Mnemonics 


Operands: 


Descriotion: 


Current Lines: 


EXAMPLESS 
Example 13 
Delete Line le 


Fxisting text: 


Enter command: 


Resulting text: 


Example 2°: 


DELETE 


R R=Range 


This command deletes the text Lines specified 
by the range *R", 


Line following Last line which was deleted. 
If last tine of the file is deleteds then the 
Last existing line of text secomes the current 
Lines. The current Line is undefined if all 
text is deletede 


Delete all Linese 


Enter commands: 


Resulting text: 


1 Text Line AA Current Line 
2 Text Line 88 
3 Text Line CC 

>DE 1 
2 Text Line BB Current Line 
5 Text Line CC 

>DE 2- 
none Current Line 


undefined 
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503205 END Command 


Mnemonic: 


Operands: 


Description: 
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END 


none 


Allows user to return to operating system 
controle The editor goes to "end of task" 
with a return code of OQ to signify normal 
terminatione 


If the user issues END before storing any 
current text on a file Cusing the SAVE 
command)» a reminder message is outosdut.e 


5e5e85 FINO Command 


Mnemonic: FIND 

Operands. SeR S2String re 
R=Range 

Description: Searches for all occurrences of the string 


specified ody S in the Range Re and outputs to 
the List device the lines containing S. 


Current Lines Last Line of Range 


EXAMPLES? 
Example 1° 
Find Line containing string "AA". 


*SEARCH FOR Current Line 


Fxisting text: 5 
6 $SYMBOL 
7 * AA 
8 *BB 
9 $cc 


Enter command: >F/S AA 95 


STRING NOT FOUND Information 
message 
Line 5 does 
not contain 
WAA™ . 
Current Line 
is still Be 


Enter commands: >F/JAAS 95-9 
List Device Qutput: 7 AA TEXT found Line 


Current Line 
is 9 
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Example 2: 
Find all Lines starting with a "*" in column 1. 


Enter commands >Fs*/1_—95- 


List Oevice 5 *SEARCH FOR TEXT found Lifes 
Output: 7 AA Current Line 
is 9 
8 *BB 


29-677 ROO 2/79 S-17 


Se5e/ FORMAT Co 


Mnemonics 


Operands: {CfdJ 


Descriostion: 


mmand 


EQRMAT 
CoP] CeHALTIC + XREF J 
C eP=-P J fd=file 
descriptor 
P=page 


number(s) 
HALT=Enable 
end-of-oage 
stop 
XREF=Enable 
cross frefe 
Listing 


This command is used to produce the formatted 
output of a documente The appearance of the 
output is based on the document text and the 
associated formatting requestsSe Before 
entering tne FORMAT command the text to be 
formatted must be available to OS/32 TEXT. 
That iss it must have deen entered from the 
command input device (@egdee CRT) or retrieved 
from a file using the GET command. 


Fach time the FORMAT command is issueds the 
initial values for certain formatting requests 
are set up (see Chapter 6)e 


Formatting begins with the first Line of the 
input text (consisting of document text and 
formatting requests) and continues until the 
Last input text line has been processed or the 
eQUIT (see Shapter 6) formatting request is 
encounterede 


If the formatted output of a document was 
directed to a files that file cannot be used 
as Input to OS/32 TEXTe The OS/32 TEXT PRINT 
command is used to copy or print ae file 
containing formatted text. 


ALlL operands except fd may be entered in any 
ordere 


The brackets enclosing the command operands 


indicate that the use of each operand is 
optional. 
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fd 


The operand fd specifies the file name or 
device to which the formatted text is output. 
when fd is omitteds formatted output is 
directed to the current List device. 


When fd specifies a files the following 
considerations apoly: 


o if fd does not existe an indexed file (of 
record tlength 132 bytes) is allocated for 
the fornatted output. 


o if fd existse the actions taken oy 0OS/32 
TEXT deoend on its current operation mode-e 


- 4nteractive mode 


if the specified fd was used in the 
Last GET comnands the FORMAT command 
is rejected. Otherwises a warning 
message is outpute The user then has 
the option to override the warning or 
to enter a new fde 


- batch mode 


if the specified fd was used in the 
Last GET commands the FORMAT command 
1s rejected and program execution 
abortede Otherwises the file 
specified in fd is deleted and an 
information message is outpute The 
specified file is then allocated as 
descrined aboves 


o the file is closeda upon completion of the 
FORMAT command. 


The braces indicate a choice of alternate 
operandse The operand P specifies a single 
page numbpere The operand "P-=P" specifies the 
beginning and ending page of a group of 
consecutive pagess When the operand is 
omitted, all pages are outpute 


HALT 


This option is useful when paper must ode fed 
manually to a printing devices or when 
reviewing formatted text dsefore printing final 
copiese The operand "HALT" specifies that 
output of formatted text is nralted temporarily 


S719 


at the beginning of each pagee Prior to 
output of the first pages the nessage "ENTER 
RETURN WHEN READY" ds displayed as a reminder 
that the HALT option was selectede This 
option is effective only if the formatted 
output is directed to an interactive device. 
To resume formatted output after a halts the «. 
RETURN key must be depressede 


XREF 

The operand XREF causes OS/32 TEXT to generate 
@ cross-reference Listing at the end of the 
formatted output. This Listing relates the 
text on the formatted output pages to the Line 
numbers assigned by OS/32 TEXT to the raw text 
and formatting requests entered by the uSere 
This option aids the user itn Locating text 


PasSagess etce in the raw text to facilitate 
document revisions. 


EXAMPLES? 

1. Output entire document to current List device. 
Enter command: >FO 

226 Cutput page 2 of document to printer. 
Enter command: FO PRioe2 


Ze Output pages 2-10 of document to current list 
device and halt before outputting each pagee 


Enter command: >FO 2-10 eH 
4e Output entire document to FILEsA on default 
volume and oroduce a cross-reference Listinge 


FILE~A does not existe 


Enter command: >FO FILE eA 9X 
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52e328 GET Comma 


Mnemonic: 


Operands: f 


Descriotions: 


Current Lines: 


EXAMPLES: 
Example 13 

Get a file from 
Enter command: 


Resulting text: 


Example 2° 
Get a file from 
Enter commands: 


Resulting text: 
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nd 


GET 


d fd=file 
descriptor 


This command deletes existing Liness then 
opens the specified file and makes the file 
contents available for processing. The file 
FItself is not changed during processinge If 
the GET command is issued before tne current 
text is saveds a reminder message its output to 
the usefre 


First Line of texte 


default volume. 


>G EXAMPLE .1 


Text from file EXAMPLE.1 Current Line 
is available for processing. 

is 1 
volume M300- 
>G MI300ZEXAMPLE e2 
Text from file EXAMPLE.2 Current Line 
4s available for processing. 

is il 


5 e5eF INCLUDE Command 


Mnemonic: 


Cescriation: 


Current Lines: 


EXAMPLES: 


Example 13 


INCLUDE 
Operands: LefdekR L=Line operand 
ofdeR fd=file name 
Leek R=Range 
Pa a 


This command inserts text Lines in the text 
currently availablee The Lines to be inserted 
may come from two sources: 


le a file 


Ce from within the current text. 


Lines specified by R from file fd are inserted 
after Line Le If L is omitted, the inserted 
Lines follow the current Line. 


when fd is omitteds the lines specified by R 
are taken from the current text. The Lines 
specified by R are inserted after Line Le I f 
L 4s omitteds the inserted Lines follow the 


current Lins. 


The original Lines specified by R are still 
available. 


Last line included. 


Include atl Lines from file EXAMPLE.1 after Line 2. 


Existing Text: 


Fnter Commands: 


2-22 


BEGIN 

THIS IS AN 

ENO OF 

EXAMPLE 

NUMBER le 

* Current Line 


Om & WM Fe 


D>INC 2eEXAMPLE.i oli - 
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Resulting texts 


Fxample 23 


Ou PW MNM PP MY PV ef 


i om ] 
p> 


oa Oo 
FON 


BEGIN 

THIS IS AN 
EXAMPLE HOW TO 
USE THE INCLUDE 
COMMAND. 

* 

END OF 

EXAMPLE 

NUMBER le 


x 


Current Line 


Include Lines 4%e596 from current text after Line l.e 


Fnter commands: 


Resulting text: 
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D>INC 1994-6 


BEGIN 

EXAMPLE 

NUMBER le 

* 

THIS IS AN 
EXAMPLE HOW TO 
USe THE INCLUDE 
COMMAND. 

* 

END OF 

EXAMPLE 

NUMBER le 


x 


Current Line 


525210 INSERT Command 


Mnemonics: INSERT 
Operands: cb L=Line 
none operand 


Descrinations 


Current Lines: 


EXAMPLES: 


Example 1° 


This command allows text Lines to be entered 
from the command input devicee The new text 
is inserted after the Line specified by the L 
operande If tL is omittede the text is 
inserted after the current Linee Line numbers 
followed by the > symbol are output as prompts 
to the usere Lines can be inserted until text 
fnput is terminated by depressing RETURN 
directly after the promot is given. 


Last Line inserted. 


Insert text after the Current Line. 


existing text: 


Enter commands: 
TEXT prompts: 
TEXT prompts: 


TEXT prompts: 


Resulting Text: 


Example 23 


1 AAA 
2 000 
3 EEE Current Line 
>INS 
3eQ1 DFF User enters: 
FF 
3e02 OGG User enters: 
GG 
3e03 SCR User enters: 
Carriage Return 
1 AAA 
2 009 
5 FEE 
3e01 FF 
3e02 GG Current Line 


Insert text after line le 


Enter command: 


5-2 4 


2INS 1 
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TEXT prompts: 1.01 58 User enters: 


B 
TEXT orompts: 1.02 dC User enters: 
C 
TEXT prompts: 1.203 DCR User enters: 
Carriage Return 
Resulting text: 1 AAS 
1.01 8 
1.02 C Current Line 
2 009 
3 EEE 
3201 FF 
3e02 GG 
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Se Sell OPTION Command 


Mnemonics: 


Ocerands?: 


Current Line: 


eserioation: 


O} 


~26 


QPTION 
See Section 
eLIST=fe 5S esellel 
eNQ_ TAB 606 Law 
eNOVERTIFY oe pon Gree 
eTAS=charactery Se 5ell eS 
STOPLleStOO2 ecevec 

VERIFY aero ene 
Unchanged 


Only tnose aderands whicn certain ic tne use 
of TEXT are discuss2d oselow., You nay refer to 
the oO8/32 EDIT User®*s Manuat for information 
about the operands which are not discussede 


AS Many oDerands as da@sired can be antered and 
in any ordere Operands must be separated by 
COMMAS e 


OS/32 TEXT orocesses the options from Left to 
right. Therefore, if conflicting oossrands are 
entered in the same option comnanays the Last 
operand given is in eftfecte 


When OS/32 TEXT 3s first executed; tre ootions 
are set to the following default vaiues:; 


BLOCK = 5 

LENGTH = 89 

LIST = determined by START arguaents 
MOOE ‘= ASCII 

NOLOG 

NOTAS 

TERMINATOR = unspecified 

VERIFY 


The values of all current options nay obe 
displayed ay entering the COTION conrarid with 
no operancdce 
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EXAMPLES? 
Examole 12 


Request display 
OS/32 TEXT. 


Assume List Dev 
Enter Command: 


TEXT outputs: 


Example 2: 

Change three op 
Enter command: 
Enter command: 


TEXT outputs: 


Example 33: 
Disolay current 
Enter command: 


TEXT outputs: 
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The current settings of the operands BLOCK, 
LENGTHe LISTs LOGe MODEe TERMINATORe and TAB 
may be individually displayed by entering 
OPTION followed by the desired ovoerand only, 
@ ee O LIST. 


of all option settings after starting 


jce is CON: 
>0 


MODE=ASCII 
LENGTH=80 
LIST=CON: 
BLOCK=5 
TERMINATOR =UNSPECIFIED 
NOLOG 
— WVERTFY 
NO TA8S 


tions and display all option settings. 
>0 NOVeLE=120 sTA=$910916 
>0 


MODE=ASCII 

LENGTH=120 

LIST=CON? 

BLOCK=5 
TERMINATOR=UNSPECIFIED 
NOLOG 

NOVERIFY 

THE TAB CHARACTER IS $ 
10 16 


option setting for MODE. 
>O MO 


MODE=ASCII 


SeSellel Operand:LIstT=fd fd=file 


descriptor 


Description: 
The responses 
Output to fde 
direct 


current text. 


EXAMPLES 


Start 0S/32 


5 G6) oe START» LIST=PR3 4 COMMAND=CON: 


TEXT starts: OS/32 TEXT Rn 


Enter Commands 350 LI=CONS 


Ses elle2 OQperands NOTA3 


Current 
already 
affected. 


Descriostion: Tab settings 


entered using 


are 
tad 


EXAMPLE: 


Enter command: >O0 NOT 


20 TA 


Enter commands: 


TEXT outputs: NO TABS 
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Causes the LIST device to be assigned 


to fde 


generated by TEXT commands are 
At times it may 
the display produced by TYPE to a Line 
printer in order to obtain a hard cooy of 


be useful to 


the 


ALL List 

output is 
directed 

to PRS 


n=revision 
numoer 


ALL list 
output jis 
directed 
to CON: 


Text 
not 


clearede 


control is 


Clear tab 
settings 


Display tab 
settings 


No tabs 
in effect 
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Se 3e112-3 Operan 


Description: 


Se sell e 4 OPeran 


Descriotion: 


EXAMPLES: 
Examole 13 


Define taos and 
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d: NOVERIFY 


This operand cancels the VERIFY optione 
"changed" Lines are not outout during 
execution of the CHANGE or COLUMN command. 


d: JA8 
TAB=ChareTlaT2eee Char=Tab 
Character 
Tn=Tab Stop 


The TAB operand allows the user to enter text 
in columnar forme The tao character is used 
to indicate where tadsulation should occur. 
The text 4S expanded by OS/3? TEXT before it 
is stored for subsequent use. When text is 
Saved or output to the terminals it is always 
in expanded form. 


TAB 


Without arguments displays the current Tab 
character and settingss or "NO TABS", 


Defines the Tad Character "char" and up to 20 
tabulation StODSs ReTletT2a™: -etec~s The Tab 
Character allows you to skip from one tab stop 
to the next. "Char™ should oe a character 
that does not occur in your texte The reverse 
slash "\" or "CTRL I" (depress these keys 
simultaneously) are recommendede rt “CER i* 
is selected, the "TAB" key nay vse used to skip 
to the tab stopse The tad stops "TlayT2eee" 
may be entered in any order. OS/32 TEXT will 
arrange them in numerically ascending ordere 
Tab stoos may pe added to existing ones 
without redefinition of established stops. 
Howevere the Tad Character must be entered 
every time a Tab Stop is entered! 


enter text using tabs. 


Enter command: 0 TA=\ 5920910 Define Tab 
Character and 
set two TAB 
STOPS. 


Enter command: >Oo TA Request 
disolay 
of taos 


Text outputs: THE TAB CHARACTER IS \ 
10 20 


Fnter Command: >A Request text 
jnout mode 


TEXT prompts: LOOATENDEPOSITNNEW SUM Enter text 
using 
tab stops 
TEXT prompts: 2>CR Enter "CR" 
(carriage 
return) 
to end 
text input.e 


Enter command: odTl Display 
Line le 


TEXT outputs: 1 DATE DEPOSIT NEW SUM 


Example 23 

Add a tab stop to existing tabSe 
Enter command: 30 TA=\el5 

Enter command: >0 TA | 


TEXT outputs: THE TAB CHARACTER IS \N 
10 15 20 
SeSelleS Operand: VERIFY 


Description: A Line which is modified during execution of 
: the CHANGE or COLUMN command is output to the 
terninales wnen VERIFY is in effecte 
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5 e353 212 PAUSE Command 


Mnemonic: 


Operands: 


Descriotion: 


Current Line: 


EXAMPLE 3 
Fnter command: 
Systen outputs: 


Enter command: 
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PAUSE 


None 


Allows user to return to operating system 
controle temporarily. To return to TEXTe the 
user issues the CONTINUE commande Upon 
re-entering TEXT, all text is available as 
before the PAUSE command was givene 


Uncnanged 


fs) 
TASK PAUSED 
CO | The OS 


CONTINUE 
conmand 


Se 5elS PRINT Command 


Mnemonic: 


Operands: 


Description: 


PRINT 

fd fd=file 
deseriotor 

none 


This command is used to print a file that was 
previously produced using the FORMAT commande 
The PRINT command can only orint a fils that 
contains formatted text. The operand fd 
specifies tie device to which the text is 
sent. Before a formatted file can ose printeds 
it must be made available to OS/32 TEXT via 
the GET commande 


A formatted file can only be printed or copied 
to another files it cannot be edited. The 
PRINT command is used for printing and 
copyinge The PRINT command orovided by TEXT 
should not be confused with the MTM PRINT 
commande 


fd 


The operand "fd" specifies the device or file 
name to which the previously formatted text is 
to be outpute 


Normallye a device is specified to obtain a 
hard copy of the documente.e The device must be 
able to handle the line width which was 
selected to create the formatted outpute 
Otherwises Loss of data will occur. The PRINT 
command does not perform any formatting to fit 
the text Lines to different devices. 


When fd specifites a files the resulting output 
is a copy of the input file. Processing of 
the file oy OS/32 TEXT is subject to the 
following considerations: 


a) If fd does not exists an indexed file of 
record length 132 bytes tis allocated for 
the formatted outpute 


b) if fd exists, the actions taken vsy OS/32 
TEXT depend on its current operation mode. 


ba) interactive mode 
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4{f the specified fd was used 


in the 


Last GET command, the PRINT command 


is rejected. Otherwises a 


warnina 


message is outpute The user then has 
the option to override the warnring or 


to enter anew fde 
bb) batch mode 


if the specified fd was used 


in the 


Last GET commande the PRINT command 
is rejected and program execution is 


abortede Atherwises the 
specified in fi is deleted 


file 
and a 


"file-deleted" information message is 
outpute The specified file is then 


allocated as described in (a) 


abpovee 


When fd is omitteds the outsut is 


directed to the current List 


EXAMPLES: 
Examole 1: 


Qutput to the Line printer the formatted document 
contained in FILEeA on the default volume. 


Enter command: >GET FILE.A 


Enter command: >PRINT PR? 


Fxample 23 
Output a second copy of FILEeA to the Line printere 


Enter command >PRINT PRS 


Examole 3: 


Make a copy of FILEe«3 on volume M300 to file FILEe°RT 
on the default volume. FILEePRT does not existe 


Enter Command: >GET M300cSFILEe-B 


Enter Command: >PR PLL e~e Rt 
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device. 


Example 4° 


Qutput a second copy of FILEeB to the current List 
device. 


Enter command: >PR 
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Se3el4 REPLACE Command 


Mnemonic: REPLACE 
Operands: R R=ange 
none 
Description: This command deletes existing text lines and 


inserts new text entered from the command 
input devicee R specifies the lines to be 
deleted. If R is not specifieds the current 
line is deletede The new text is inserted in 
place of the first Line delet2d sy the 
commande AS many tines as desired can be 
iInsertede OS/32 TEXT outputs a Line number 
followed by the ">" symbol as a prompt to the 
user for the new text Lines. Text input jis 
terminated by depressing RETURN directly after 
the prompt is givene 


Current Line: Last Line entered. 


EXAMPLES: 


Example 13 


Reolace Lines 2-4 in current text. 


Existing text: 1 * THIS TEXT IS PART OF 
2 * A NEW DOCUMENT 
z * 
a * FIRST THING IS TO 
= * REVISE Current 
Line 


Enter command: >REP 2-4 


TEXT prompts: 2 >* AN OLD DOCUMENT User enters: 
text 

2e01 >* PUB NO” 777 Jser enters: 
text 

2e02 DCR User enters: 


Carriage return 


THIS TEXT IS PART OF 

AN OLD DOCUMENT 

PUB NO. 777 Current Line 
REVISE 


Resulting Text: 


+ +4 + © 
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Example 2: 


Replace text in Current Linee 


Enter command: >REP Range 
¥s null 
TEXT prompts: 2e015* DOC NOe 40-372 User enterss: 
text 
20e02>*%* =ROM PROUeAQ FILE Yser anters: 
text 
2e035CR User enters: 


Carriage Return 


Resulting text: 1 * THIS TEXT IS PART OF 
2 * AN OLD DOCUMENT 
2e01 * DOC NO e 40-372 
2002 * FROM PROJVeQ FILE Current Line 
5 * REVISE 
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SeS3el5 SAVE Com 


Mnemonic: 


Operands: 


Descriptions: 


Current Line: 


EXAMPLES: 
Example 1: 
Output entire t 
Enter command: 


Resulting text: 


Example 2: 
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mand 


SAVE 

fd fd-file 

* descriptor 
fdoerR xzcurrent 

a Ba input file 


R=Range 


Outputs text being edited to a file or device. 
If fd specifies a file which does not 
currently existe an indexed file is allocated 
witn the nane fde Upon comoletion of the SAVE 
commands the text output to fd is stitl 
available for further editing. 


If fd is the name of an existing files O0S/32 
TEXT does not save the text in that file in 
order to prevent accidental destruction of a 
master file. Insteade a warning message is 
issued and 0S/32 TEXT awaits a user responsee 
The user has the option to use the specified 
file or to specify a new fd. 


The operand "x" may be used to specify the 
file that is currently being used as the input 
file. In this cases the file Is overwritten 
with the text currently being edited. 


The ooerand "R" specifies tne text Lines to be 
outpute Tf "R® Ys omitted, all text Lines are 
outpute 


Last line output. 


ext to "FILEeA" on default volume. 


>S FILEeA 
Entire text still Current Line 
available. is Last Line 
tin text. 
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Output Lines 1-10 to FILEeB on volume M300. 

Enter commands >S M300 SFILE-Be1l-10 

Resulting text: Entire text stitl Current Line 
available. js Line 10 

Example 3° 


Output entire text to the file which was used in the 
Last "GET" commande 


Enter commands: >S x 


Resulting text: Entire text still Current Line 
available. is last line 
in texte 
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Se3el16 SEND STO 


Mnemonic: 


Operands: 


Description: 
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P Command 


SEND STOP 


None 


This command allows the user to terminate the- 
execution of lengthy commands and regain 
control of command input mode in OS/32 TEXT. 


Commands affected by S=ZND STOP ares CHANGE s 
COLUMNe FINDe FORMATs PRINT and TY°Ee 


The command is only valid durtng interactive 
use of QOS/32 TEXT and when the program is 
executing under either of the following 
conditions: 


o as a foreground tasks where OS/32 TEXT is 
the current task 


Oo as aterminal taske under an MTM— system 
generatea to allow tasks to receive messages 
via the O0S/32 SEND command 


SEND STOP is entered in response to an OS or 
MT™M prompte A prompt is obtained oy 
depressing the BREAK keye possibly several 
times. 


Entering SEND STOP causes OS/32 TEXT to 
terminate oorocessing of the command issued 
Just prior to SENO STOP. After processing the 
SENO STOP commande OS/32 TEXT 18 ready to 
accept the next command. 


Be 3017 TYPE Command 


Mnemonics: 


Operands: 


Descrintion: 


Current Line: 


EXAMPLES: 


Example 1°: 


LYPE 


R R=Range 
none 


Outputs one or multiple Lines to the List 
device as specified by Re When R is onitted,s 
only the current Line is outout.e 


Last line output.e 


Display all existing text Linese 


Existing text: 


Enter commands: 


TEXT 
TEXT 
TEXT 
TEXT 


Example 23 


Cisplay current line. 


Enter commands: 


TEXT outputs: 


Example 3: 


Display Line 2.01. 


Enter command: 


TEXT outputs: 


1 AAAA 

2 BB38 

2e01 CCCC Current Line 

3 DDO0 
>T1l- 

1 AAAA 

1 BBSB 

2e01 CCCC 

3 0030 Current Line 
>T 

3 DODD Current Line 
>T 2e01l 

2001 ‘*CECCC Current Line 
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505018 Display 


Mnemonic: 


Operands: 


Descriotion: 


Current Line? 
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Next Line(s) 


+ (plus sign) 


RETURN 
n nis an 
none integer 


Outputs the nth tine following the current 
Line to the List device. If the operand is 
omitteds the next Line ts output, as this is 
equivalent to the nz=le If the operand n is 
greater than the number of following Lines in 
the textes then the last Line of text is output 
with the information message "LAST LINE". 


This command can be used to position the 
current line. It is especially useful for 
positioning to Lines with duplicate Line 
numbers which have resulted from the INSERT, 
REPLACEs or INCLUDE command. 


Depressing RETURN directly following the 


prompt is equivalent to +1, and causes the 
next Line to be displayed. 


The displayed Line. 


5263219 Display Previous Lines) 


Mnemonic: 


Operands: 


Description: 


Current Line: 


-(minus sign) 


n n is an 
none integer 


Outputs the nth preceding line in the file to 
the List devicee If the ooerand is omitted, 
the preceding Line is output. This is the 
equivalent of n=l. If the operand n is 
Greater than the number of preceding lines in 
the texts then the first Line is outputs along 
with the information message "FIRST LINE". 


This command can be used to position the 
current Linee It is especially useful for 
positioning to Lines with duplicate Line 
numbers which have resulted from the INSERT, 
REPLACEs or INCLUDE command. 


The displayed line. 
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5 e353e20 Line Number 


Mnemonic: 


Operands: 


Descriotion: 


Current Line: 
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2/73 


Line number 


text 
none 


Depending on its uses a "Line number" provides 
the capabilities of the OELETEs INSERTe and 
REPLACE commandse The "Line number" command 
actions are as follows: 


0 Delete 


A Line number without an ooerand deletes the 
specified Line. 


o Replace 


A Line number with a "text" operand replaces 
the specified Line with the new text, if the 
Line existse 


o Insert 


A Line number with a "text" operand inserts 
the specified Line in the proper numeric 
position in the current text, if the 
soecified Line does not exist. 


The "line number" must be separated from the 
"text" by a space@e 
ad with "text" operand: specified Line number 
bd) without operand: Line following deleted 
Line or the preceding 


Line if the Last Line 
was deleted 
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CHAPTER 6 
DESCRIPTION OF FORMATTING REQUESTS 


Bel INTRODUCTION 


This chapter presents detailed informatton for each 0OS/32 
TEXT formatting request. The material in this chapter is 
intended for reference usee The general usage of formatting 
requests is described in Chapter 4. 


Section Gelel oOrovides a cross reference index by funetions 
to the alphabetical Listing of formatting requests in Section 
Bese 


Section 642 explains the syntax of the formatting requests. 


Section 643 contains descriptions of all formatting requests 
in alphabetical order. 


Section 624 lists the initial values of formatting requests 
which have such a value. 


6belel Cross-Reference Index to Formatting Requests 


The index lists formatting requests based on their functional 
relationship. The mnemonics for the formatting requests are 
indicated by capital Letters. 


o Define Page Size 
Line WIOTH 
Page LENGTH 
o Marain Control 
MARGIN deftnitton (absolute) 
Left MARGIN adjustment (relative) 
Right MARGIN Adjustment (relative) 


Top MARGIN 
Bottom MARGIN 


o Text Line Filling 
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fe) 


e) 


0 


0 


0 


fe) 


FILL output Lines 
do NOt FILL output Lines 
BREAK 


Text Line Positioning 


Left JUSTIFY 
Right JUSTIFY 
INDENTation 

new PARAGRAPH 
CENTERed text 
WIDOW PREVENTIon 


Text Line Spacing 


Line SPAC(E) Ing 
SKIP Line 
page EJECT 


Page Titles 


page NJMBER ing 
Top TITLE 

Bottom TITLE 

EVEN TOP Title 
EVEN BOTTOM Title 
000 TOP title 

OD0 BCTTOM title 


Footnotes and Tables 


FOOTNOTES 
floating KEEP 
jn context BLOCK 


Revision Identification 


revision 8AR 
revision LEVEL 


Special Handling of Characters 


OVERPRINT 
special BLANK 
UNDERSCORE 
SOLO FACE 
HYPENATCE)CIon 
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0 Date and Time Functions 
MONTH 
DAY 
YEAR 
time of DAY 
o Text File Merging 


IMBEO file 


o User Interaction 
RETURN to user 
QUIT processing 


COMMENT 
change CONTROL character 


602 Syntax 
ALL formattina requests described in 
following format: 

erequest argument 


wheres 


o the period "." dis a control character 
if necessary the control character can 
the eCONTROL formatting request; 


o request is the name of the formatting 


described; 


o the underlined part of the request and 
minimum acceptable abbreviations 


chapter use_ the 


generally used; 
be redefined by 


request being 


argument is the 


o the request is separated from the argument oy at Least 


one blanks 


Oo argument may be ae single characters 


worde 


Notations that describe arguments ate: 


a numbefs or a 


o brackets € J indicate an optional argument 


Oo braces { } indicate a choice of arguments 
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Formatting requests and their arguments may be entered in 
upper or Lower case Letters. 


A formatting request must always be entered on a line by 
itself and must appear at the beginning of that Line. 
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6e3 DESCRIPTION OF FORMATTING REQUESTS 


This section presents the formatting requests in alphabetical 
oraere 


In the descriptionss the initial value is given for each 
formatting request if applicable. 


The inittal values are automatically reset each time the 
FORMAT command is entered to produce a formatted document. 
Section 6e4% contains a summary of initial valuese The 
examples presented in the formatting request descriptions 
assume these initial values unless they are explicitly 
chang2d in an example. 


For formatting requests which have optional arguments, the 
values which are substituted when arguments are omitted are 
given. 


The descriptions also indicate whether or not the particular 
formatting request causes a "break" in the formatted outpute 
Please refer to the description of the eBREAK formatting 
request for the definition of break. 
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Gesell Reviston Bar 


je 

ie) 

{> 
7 


BEGINe number 
END 


Initial Value: none 


Breaks yes 


This formatting request is used to identify modifications to 
a documente The arguments BEGIN and END delimit the modified 
texte In the formatted outputs the modified text is marked 
by revision barse The argument "number" assigns a revision 
Level number to the modified texte This revision Level 
number #s usea in conjunction with the eRLEVEL formatting 
request to enable/disable the output of revision bars during 
formattinge 


The placement of revision bars in the formatted output is 
subject to the following considerations: 


o The revision oars aoddear separated by two (2) columns 
from the text area in either the Left or right margin 
(see below). The margins must therefore be defined 
sufficiently wide enough to contain the revision bar. 


o If no even/odd page titles are defineds the revision 
bar appears always in the right margin, 


o If an even or odd page title is defineds the bar 
appears fn the right margin on odd numoered pages and 
in the Left margin on even numbered pageSe 


EXAMPLE: 


Assume you have a document that was modified once and is at 
revision Level 1 - and you want to add two modifications 
under revision Level two (2). 


Existing text 

Enters eBAR BEGINe2 
Modified Text Section 1 
eBAR END 
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Enters 


Please 


eBAR BEGINe2 
Modified Text Section 2 
eS8AR ENO 


see example inthe 


eRLEVEL 


procedure to control display of 
formatted output. 
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description 
revision bars 


for 
in 


the 
the 


G6erse2 Special 3lank 


eBLANK Ccharacter] 

Initial Values $ 

Default: $ or character specified in last eBLANK requeste 
Break: no 


The argument "character" specifies a single character.e 1 f 
the argument is omitteds the default value is assumede 


The next text Line is Scanned for the presence of 
"character". Fach occurrence of that character is replaced 
by a blank (space). Ouring formattings the special blank 
character is considered a noneblank charactere This means 
that text on either side of the special blank character is 
not spread out or split across two Linese 


EXAMPLES 

Normally,» two blanks are placed after each period ine the 
formatted output text. This may not always be desirable in 
names and titlese for instancee The following example shows 
the use of a special blank in a name. 


Enters «BLANK 
My name is ODreSAeSPHILLIipse I am a surgeone 


Result: My name is Ore Ae PHILLipse [I am a surgeone 
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Bese3 IN Context Block 


BLOCK / BEGIN 
ENO 


Initial Values none 


Breaks yes 


This formatting request is used to define a block of text 
such as ae table. The arguments BEGIN and END delinit the 
text within a blocke “In context" means that the text in the 
block appears within the formatted output text at the same 
place where it was enterede 


During the formatting process,» the block is treated in its 
entirety to prevent splitting of the text psetween pagese The 
placement o f the block is subject to the following 
considerations: 


(a) If the current page contains texts the block is placed 
on this page only if the block fits entirely on the 
current page. 

(b) If the current page contains text and the block does not 
fit entirely on this pages the balance of this page 
remains empty and the block is output starting at the 
too of the next page as described in (cc) belowe 

(c) If the current page contains no texts output of the 


olock is started and then continued on subdsequent pages» 
if necessarys until all text in the block is output. 


The placement criteria described in (b) above is the only 
difference in the processing of a block of text defined as an 
In context eB8LOCK and a floating .KEEP. 
The followina restrictions apply to in context olocks: 

o blocks cannot be nested 

o blocks cannot contain floating keeps 


0 blocks cannot contain footnotes 


0 eject requests within the block are ignored 
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Ge5e4 Bottom Margin 


e3MARGIN Lines 
Initial Values 5 


8reaks yes 


This formatting request specifies in the argument the number 
of blank "Lines" to occur at the bottom of each pagee If a 
bottom title is specifieds the bottom page title is centered 
vertically within this space. 


when the bottom margin is odde an equal number of blank Lines 
aooear above and below the title. When the bottom margin is 
evens one more blank Line appears above the title than below 
the titlee 
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Ge5e5 Bold Face 


eBOLDFACE 
Initial Values none 


Breaks no 


This formatting request causes overprinting of all characters 
tin the mext text Line to give them a darker appearance. 
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60306 BREAK 


oBREAK 
Initial Values none 


Breaks: yes 


The taxt lines immediately preceding and following this 
formatting request are not concatenated to fill output lines. 


The description of each formatting request in this chapter 
indicates whether or not the request causes a Dreake 
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Bede7 Bottom Title 


eBITITLE S/Si/S2/S83/ 
Inittal Value: none 
Break: no 
This formatting request is used to specify a page title which 


apoears at the bottom of each page in the space defined as 
the bottom margin. 


The bottom title may consist of up to three independent 
sections as defined by the argument sections /S1/S8S2/S3/5~- All 
three sections appear on the same Line in the bottom margin 
and are positioned with resoect to the margin settings 
currently in effect as follows? 


o S1 is Left justified 

0 $2 is centered between the margins 

0 $3 ts right justified 
Any of the three sections may be empty. Each section must be 
separated by a delimiting symbole In the above descriptions 
a slash "/" ds usede Any characters exceonpt a blanke may be 


used as the delimitere The first character in the argument 
¥s assumed to be the delimiter. 


The page number symbol may appear either in Sle S2e or S36 
In the formatted output, the page number symbol is replaced 
with the computed page number for the current page. 


EXAMPLES: 


1. Specify a three-section bottom title with 
page number symbol in section number 3. 


Enters eBTITLE /TEXT/MANUAL/PAGE K&/ 
Results:Assume page count equals l. 

TEXT MANUAL PAGe Il 
2e Specify a twor-section bottom title. 


Section two is empty. The delimiter 
js the asterisk.e 
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Enter: eBT *Volume I**tNOwe 1-%*% 
Result:Assume page count equals 10. 


Volume I Noe 1-10 
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6e3e8 Centered Text 


CENTER CBEGINI 
CENDI 


Initial Values: none 
Default: Only next text Line is centered. 


Break: yes 


This formatting request causes text Lines to be centered 
between the Left and right margins currently in effect. 


when the request is specified without an arguments only the 
next text Line is centered. 


To center a group of successive text lLiness they must be 
delimited by the BEGIN and END argumentse When text is being 
centered, Left and right justification and filling of output 
Lines are suspended. This means that text lines appear in 
the formatted output exactly as they were entered - except 
they are centerede 
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Ge3295 Comment 


2COMMENT note 
Initial Value: none 


8reak: no 


This formatting request allows the user to insert comments 
throughout the raw text to keep notes for personal use 
concerning the preparatione maintenancee and formatting 
requirements of the document. The argument "note" is any 
infornation that the user wants to insert. 


The eCOMMENT request is not processed during the execution of 
the FORMAT command and the "note" does not appear itn the 
formatted text of the docunente 
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6e3e10 Change Control Character 


eCONTROL character 
Initial Values e (period) 


Break: no 


This formatting request allows you to change the control 
charactere The control character is the first character of 
each formatting request. 


Rememder that each formatting request has to be entered on a 
Line by itself and that it must appear at the beginning of 
that Line. 


If document text must be entered in such a way that a period 
fs required at the beginning of a Lines the formatting 
request control character can de changed. Once changede the 
new character is in effect for att subsequently entered 
requestSe 


EXAMPLE $ 


You want to enter columns of fractions starting at the 
heginning .of each Line. You change the control character 


temporarily to a semicolon "$3" and reset again to a period 
moet, 


Enters eBLOCK SEGIN 
eCENTER 
TEMPERATURE COEFFICIENTS 
eCONTROL 3 
sNOFILL 
sSKIP 
0000 20017 00035 00052 etCe 
00175 etCe 
00349 etCe 


02419 02436 etce 
sBLOCK END 

s;CONTROL ef 

oF Hk 
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Gesell ODay (from system) 


eQAY Ccharacter] 
Initial Value: none 
Oefault: no character appended 


Sreak-e no 


This formatting request reads the system clock and inserts 
the day of the month into the formatted output text. The day 
is represented as a one or two digit number. 


The argument "character" specifies a single character which 
is appended to the day in the formatted output. This 
character is used primarily to add punctuation to the date. 


Examples: 


This example shows how you can request the insertion of days 
months and year into the formatted documente 


Enter: eLM +40 
123 Apricot Street 
Lintonse New Jersey 
oMONTH 
eDAayY 9 
e YEAR 
eLM RESET 
eSkK 1 
Dear Sirs: 
eoSK 1 
In this month of 
e MONTH 
the company 


Result: 
123 Apricot Street 
Lintons New Jersey 
April 4%», 1378 


Dear Sirs? 


In this month of Apritese the company eee 
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Ge3e1l2 Page Eject 


ehJECT 

Inittal Value: none 

Break: yes 
This formatting request causes termination of text output to 
the current pagee The next text Line apoears on a new page. 


Howevere bottom marginse bottom titles and footnotes, if any 
of these are specified» are output to the current page. 


If the current page is full when the .EJECT request is 
encountereds the request is ignored since OS/32 TEXT is about 
to output a new pagee 
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Be5el3 Even Bottom Tittle 


2c VENBOTTOM /S1/S2/8S3/ 
Initial Value: none 


3reaks no 


This formatting request is used to specify a page title which 
appears at the bottom of each even numbered page in the space 
defined as the bottom margin. 


The bottom title may consist of up to three independent 
sections as defined by the argument sections /S1/S2/S3/.- ALl 
three sections adpear on the same Line in the bottom margin 
and are positioned with respect to the current margin 
settings as follows: 


® S1 is left justified 
e S2 is centered between the margins 


® S3 ts right justified 


Any of the three sections may be empty. Each section nust be 
separated by a delimiting symbole In the above descriptions 
a slash "/" 4s usede Any characters except a blanks may be 
used as the delimitere The first character in the argument 
4s assumed to be the delimiter. The page number sympol may 
appear in either Sl» S29 or S3. In the formatted outputs the 
Page number symbol is replaced with the computed page number 
for the current pagee For examples see eBTITLE. 


The use of this request causes revision barss as specified by 
the eBAR requeste to appear in the right margin on odd 
numbered pages and in the Left margin on even numbered pages. 


6-20 29-677 ROO 2/79 


Ge3e1% Even Top Title 


eEVENTOP /S1/82/S3/ 
Initial Values’ none 


Break: no 


This formatting request is used to specify a page title which 
appears at the top of each even numbered page in the = space 
defined as the top margin (see eTMARGIN)- The top title may 
consist of up to three independent sections as defined by the 
argument sections /S1i/S2/S3/.-. ALL three sections appear on 
the same Line in the top margin and are positioned with 
respect to the current margin settings as follows: 


e Sl is left justified 
e S2 is centered between the margins 


® $3 is right justified 


Any of the three sections nay be empty. Each section must be 
separated by a delimiting symbole In the above descriptions 
a slash "/" 4s uSede Any characters exceot a blanks may be 
used as the delimiter. The first character in the argument 
is assumed to be the delimitere The page number symbol may 
appear in either Sis S2s or S3.-. In the formatted outputs the 
page number symbol is reolaced with the computed page number 
for the current pagee For examplesys see eSTITLE.e 


The use of this request causes revisions barss as specified 
by the eBAR requests to appear in the right margin on odd 
numbered pages and in the Left margin on even numbered pages. 
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6Ge3eil5 FILL Output Lines 


oF ILL 
Initial Value: eFILL 


Break: yes 


This formatting request causes raw text Lines to be 
concatenated to filt output Lines during the formatting 
procesSe 


To fill output Lines words are collected from the raw text 
Lines and assembled into output text Lines according to the 
margins indents and justify specifications. Leading blanks 
are stripped fron allt words in the text Lines and the 
occurrence of nore than one plank between words is ignored. 
(See eINOENT and eNOF=ILL for exceptions to this rule.) 


Words are placed in the output line until a word does not 
fite This word becomes’ the first word of the next output 
Linee khen the first word which does not fit in the output 
Line appears in the Line following a eHYPHENATE requests an 
attemot is made to hyphenate that worde 


A temporary suspension of the filling of output Lines nay be 
caused by a text line that contains only blanks or by a 
formatting request which causes a "breake" The formatting 
request descriostions in this chapter indicate which requests 
cause a breake Note that a document text line consisting 
entirely of blanks will appear in the formatted output texts 
unless it occurs in a footnotee 


After the output Line has been filled in this manner, the 
Line is adjusted as follows: 


@ when both left and right justify are in effects 
multiple spaces are added between words so that the 
output Line touches both marginse However, the Last 
Line in a paragraph is not spread. 


@ when only left or right justify is in effects the 
output line is adjusted to touch the Left or right 
margin onlye 


e when neither Left nor right justify is in effects the 
output Line is Left justified only. 
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Input Lines correspond exactly to output Lines only when 
eNOFILL 4s specified. Please see Chapter 4 for more 
infornation on output Line filling. 
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6e53e165 Footnotes 


FOOTNOTE 3EGIN 
END 


Initial Value: none 


3reak: no 


This formatting request is used to define the text of a 
footnote. The arguments BEGIN and END delimit tne text 
belonging to each footnote. 


The footnote is output at the bottom of the current page. If 
not enough space is available on that pages output of the 
footnote fs continued on sudsequent pages until comoleted. 
The space allocated for footnotes on a page does not exceed 
one fourth of the text area available between the top and 
bottom marginSe 


The text of a footnote is separated from the document text by 
a dashed line. 


Footnotes are processed subject to the formatting requests 
currently in effect. The following considerations apply: 

@ Footnotes are processed sequentially. That means, 
when multiple footnotes are encountered in short 
successions the first footnote encountered is output 
completely before the second onee etce Output of up 
to 10 footnotes may be pending at a time. 

9 Footnotes may not be nested. 

® Footnotes may not contain eKEEP or eBLOCKe 


e Footnotes are always single spaced. 


@ The eEVECT and «SPACE formatting requests are ignored 
if they are encountered in the text of a footnote. 


e Blank Lines in the text of a footnote do not apoear in 
the formatted outpute 


6-24 29-677 ROO 2/79 


besel7 Hyphenation 


eHYPHENATE Ccharacter] 
Initial Value: - (dash) 


Default: - (dash) or character specified in last 
eHYPHENATE requeste 


Breaks no 


This formatting request affects only the next line of 
document texte The argument "character" is a hyphenation 
indicator which allows you to specify words to be 
conditionally hyphenated. 


If the words containing the hyphenation indicators fit on the 
the current output Line, they are output without hyphens.e 
Otherwises OS/32 TEXT attempts to use one of the indicated 
hyohens to hyphenate the Last word on the Lines atl other 
hyohens in the word are not outpute 


To indicate conditional hyohenation in a word that normally 
contains a hyphens the normal hyphen (dash) and the 
hyohenation indicator must be entereds e@eges tailor--made. 
If the indicator had been changed to an "8"»_9 you would enter 
tailor-amade. This assures that the mandatory hyphen in” the 
word will always appear in the formatted outpute 


Please note that the above procedures apply only to words in 
the text line that 4s preceded by an eHYPHENATE request. 
That means that in any other text Lines words that normally 
contain hyphens are entered without the nayph2nation 
indicator} Cede happy-go-lucky. 


Renmemodere when entering text lines you do not hyphenate words 
at the end of a line as you would on a typewriter pdecause the 
Last character on one Line and the first character on the 
next line are treated as separate wordse See Chapter 4 
(Entering Text)e 


EXAMPLES? 
le This example illustrates conditional hyphenation of words 
that are not normally written with a hyphene The 
hyphenation character is changed. 
Enters eMARGIN 1420 
eHYPHENATE 9 
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This is an excelalent example of hyphenadtion 
tion of a worde 


Result:This is an excellent 
example of hyphena- 
tion of a word. 


2e This example illustrates conditional hyphenation of words 
that are normally hyphenatede The hyphenation indicator 


is still the initial values: - (dash). 


Enters eMARGIN le2dl 
eHY 
My friend Ys a happy=-gor--Llucky fel-low. 


Result:My friend is a happy- 
gorlucky fellowe 


3. This example illustrates the use of a hyphen without 
use of the eHYPHENATE requeste 


Enters eMARGIN 1927 
Abraham Lincolns 1809-18656 was the 16th 
president of the United States - from 1861-1865. 


Resultt:Abraham Lincoln, 1809-18655 
was the 16th president of 
the United States = from 
1861-1865. 


the 


6-26 29-677 ROO 2/79 


6e3e18 Imbed File 


x 4 
wm 
m 
© 
—h 
Qa. 


el 
Initial Value: none 


Breaks: no 


The eIMSED formatting request allows the user to insert the 
contents of another file into the document currently being 
formattede The argument "fd" specifies the name of the file 
(file descriptor) which contains the text to be inserted. 


The file being imbedded may itself contain an -IMBED request 
for yet another file and so on up to a level of ten files. 
The file may contain either text or formatting requests or 
bothe 


Formatting of an imbedded file ts terminated when end-of-file 
or a eQUIT formatting request is encountered. Formatting 
then continues with the text that contained the .IMBED 
request. 


Please see Chapter 4 for application guidelines of the .eIMBED 
request. 


EXAMPLES? 


le Imbed the contents of the file named FILEeAe 


Enter: This is IMBED-Example Noe le 
eIMBED FILEeA 
End of Example Noe le 


Result: This is IMBED-Examople Noe le 
Text from FILE.A 
End of Examole Noe le 


Qe Imbed the contents of files named FILEe3 and FILEeCe 
FILEeB contains text, followed by an eIMBED request for 
FILE «Cs and some more texte 


Enter: This is IMBED-Example Noe 2. 
eIMBED FILE.B 
End of Examole Noe 2e 


Result:This is IMBED-Example Noe 2-6 
Text from FILE.B = part il 
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Text from FILE.C 
Text from FILE.B 


- part 2 


End of Example Noe 2 
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6e3e19 Indentation 


eINDENT/ C+] columns 
- columns 


Initial Values none 


Breaks yes 


This formatting request defines a change in the left margin 
for the next text Line only. The argument "columns" 
specifies how nany columns (character positions) the left 
margin is to be adjusted from its current setting. 


If the argument specifies a positive values the margin is 
moved to the rights if negatives it is moved to the left. 


A special casey outdenting, occurs when the margin is 
adjusted to the left. In this case» text appears to the left 
of the current Left margin settinge Any text appearing in 
this area is not adjusted: meaning that leading spaces and 
multiple spaces osetween words are never deleted. This 
feature permits labelling of paragraphs. Any text appearing 
to the right of the Left margin is subject to adjustment if 
eFILL ts in effect. 


EXAMPLES: 
le This is an example of indenting. 


Enters eMARGIN 10935 
eINDENT 5 
The eINDENT request starts a new 
Saragraoh and adjusts the left margin 
of the first Line in that paragraphe 


Result: The e~INDENT request 
starts a new paragraph 
and adjusts the left 
margin of the first Line 
in that paragraphe 


2e This is an example of outdenting. 


Enters: eMARGIN 10450 
623219 INDENTATION 
The paragraph Label 623-19 plus one space 
appear to the Left of margin 10. The 
Leading spaces in front of INDENTATION 
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are removed because .eFILL Is in effecte 


Result:6e3e19 INDENTATION 
The Paragraph label 6e3-19 plus one 
space appear to the Left of margin 10-6 
The leading spaces in front o f 
INDENTATION are removed because eFILL 
is in effecte 
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6e3220 Floating Keep 

eKEEP 3EGIN 

END 

Initial Values none 

3reak: no 
This formatting request is used to define a block of text 
such as ae tablee The arguments BEGIN and ENO delinit the 
text within a block. "Floating keep" means’ that the 


placenent of the block wtthin the formatted output text may 
not always be tn the same place where the block was entered. 


The placement of the block is subject to the _ fotlowing 
considerations: 

a) If the current page contains no texte output of the 

block is started and continued on subsequent pagess if 


necessary, until all text in the block is output. 


b) If the current page contains texts the block is placed 
on this page only if it fits on it entirely. 


c) If the current page contains text and the block does not 
fit entirely on this oages the balance of this page is 
filled with text which was entered after the blocke The 


olock is then output starting at the top of tne next 
page as described in (a) above. 


The placement criteria described in (c) above its the only 
difference from the processing of a block of text defined by 
eBLOCK e 
Restrictions: Floating Keeps 

o cannot oe nested 

0 cannot contain e~BLOCK 


Oo cannot contain footnotes 


O eEVECT requests within the cefined olock are ignored. 
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6eSecl Left Justify 


ok 


ic. 
Cc 
” 
~~ 
ome | 
“Ti 
~< 
rary 


Initial Values ON 
Default: ON 


3reaks: yes 


When the ON argument is selecteds this formatting 


request 


causes output Lines to be justified against the left margine 


If the argument is omitted from the requests the ON condition 
is assumede Left justification of output Lines is subject toa 


the following considerations: 


o When both eLJUSTIFY and eRJUSTIFY are turned OFF, the 


output Lines are left justified. 


o Left justification is temporarily suspended 
following formatting requests: 


eCENTER 
e INDENT 


ePARAGRAPH 


oy the 
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6e3e-22 Line Width 


eLwIOTH columns 
Initial Value: 385 


3reak: yes 


This formatting request defines the physical width of the 
Dage that will contain the formatted documente The argument 
Wcolunns™ expresses the width in character positions that fit 
ona linee 


The Left and right margins are offsets within this Limit. 


The initial value corresponds to an 8 1/2" paper width. 
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6e3e23 Left Margin Adjustment (Relative) 


eL MARGIN C+] columns 
- columns 
RESET 


Initial Value: none 


Break: yes 


This formatting request allows you to make margin adjustments 
relative to the Left margin currently in effect. 


The argument "columns" specifies the number of character 
positions the margin is to be adjustede The margin can be 
adjusted to the left (=-) or to the right (+). The new margin 
remains in effect until changed againe 


Each time a margin adjustment is mades OS/32 TEXT records the 
Left margin setting that was in effect prior. to the 
adjustmente A total of ten (10) margin adjustments can be 
recorded by OS/32 TEXT. 


The RESET argument is used to return the Left margin setting 
to its previous setting. 


Multiple adjustments or resets may be performed in 
successione Fach request corresponds,y, in reverse order, to 
its equivalent adjustment requeste If more requests are 


entered than adjustments were nadesy the margins remain at the 
current setting. 


The recording table for the margin adjustment is cleared each 
time the FORMAT command is issued or the .eMARGIN request is 
processede 


The following examole illustrates the use of eLMARGIN. 
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EXAMPLES 


Left and right 


margins are defined followed 


adjustments and reset requestse 


Enter 


eMARGIN 16966 


eL MARGIN +3 


oRM =2 
oLM -10 
oRM RESET 
e LM RESET 


29-677 ROO 2/79 


Result 
Margins are 16966 
(Text area occupies 17-65) 


Margins are now: 1535966 
(Text area occupies 20-65) 


Margins are now: 19963 
(Text area occupies 20-62) 


Margins are now: 9463 
(Text area occupies 19-62) 


Margins are now: 39966 
(Text area occupies 10-65) 


Margins are now: 19466 
(Text area occupies 20-65) 


Dy 


multiple 


6e3e24 Margin Definition (Absolute) 


e MARGIN Left marginegright margin 


Initial Value: 12674 


Breaks yes 


This formatting request sets the absolute left and right 
margins of a page@e 


The arguments represent character positions or columns on the 
physical pages counted from Left to right. Their value must 
be within range of the Line width defined by the eLWIDTH 
formatting requeste 


The arguments "Left margin" and "right margin" define’ the 
number of blank columns which appear to the Left and to the 
right of the text area respectively. 


The margins provided as the inittial values are the commonly 
used settings for page size 8 1/2" x 11", 


Generallys the margins set by this request remain in effect 
throughout the formatting of a documents providing a 
reference base for temporary changes in the margin settings. 


The formatting requests eLMARGIN and eRMARGIN allow you to 
make margin adjustments relative to the sattings defined by 
eMARGINe The formatting requests eINDENT and .PARAGRAPH 
allow you to temporarily override the Left margin setting to 
facilitate indenting and outdenting of a text Line. 


EXAMPLE $ 


eL WIDTH 80 
eMARGIN 15966 


The resulting eighty character text line has 


fifteen blanks,» followed by fifty characters 
of texts followed by fifteen blanks. 
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6e3e25 Month (from system) 


eMONTH Ccharacter] 

Initial Values none 

Default: no character appended 
Break: no 


This formatting request reads the system clock and inserts 
the current month into the formatted output text. 


The months are represented by the words: Januarys Februarye 
etce 


The argument "character" specifies a single character which 
is aopended to the month in the formatted outpute This 
character is used to add punctuation to the datee Please see 
eJAY for an example. 
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6e30e26 DO Not FILL Output Lines 


sNOFILL 
Initial Value: eF ILL 


3reaks yes 
This formatting request inhibits the effect of eFILLe 


This means that: 


9 formatted output text Lines are not filled by 
concatenating new text Lines; 


o Leadina spaces are not removed from words; 
9 multiple spaces between words are not removeade 


o the output Lines are adjusted to touch the current 
Left margin if 


- left justify is in effect 
- poth Left and right justify are in effects or 
- both Left and right justify are OFF 


o the output Lines are adjusted to touch the current 
right margin if right justify is in effect. 


The result is that formatted output lines correspond exactly 
to raw text Lines except for the effects of margin settingse 
centeringe and left/right justification requests as Listed 
abovee 


A typical application of this request is to prepare text in 
table form where rows and columns of infornation nust appear 
exactly as they were entered by the user, 


It is important to remember that when NOFILL is tin effecte an 
inout Line cannot contain more characters than space is 
available in the output lines The available space in the 
output Line is determined by the Line width specification 
minus the current margin settings. 
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EXAMPLE: 
eLWIOTH 80 
eMARGIN 10¢70 
eNOFILL 


Available Space: 59 


29-577 ROO 2/79 


spaces 


6e53e27 Odd Bottom Title 


eODDBOTTOM /4S1/82/83/ 

Initial Value: none 

Breaks no 
This formatting request is used to specify a page title which 
appears at the bottom of each odd numbered page in the space 


defined as the bottom margin (see eBMARGIN). For details 
please refer to the descriation of eEVENBOTTOM. 
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603228 Odd Top Title 


eOD0TOP /S1/82/837/ 
Initial Value: none 


Breaks: no 


This formatting request ts used to specify a page title which 
appears at the top of each odd numbered page in the space 


defined as the top margin (see eTMARGIN)«- For details please 
refer to the description of eEVENTOP. 
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Bede23 Overprint 


eQVERPRINT (Cceharacter] 
Initial Value: / 


Default: / or character specified in last 
eOVERPRINT requeste 


3reak: no 


This formatting request causes overprinting of a specified 
character in tne text Line directly following the request. 


The argument "character" defines the overprint indicator. If 
the argument is omitted, the overprint character is the 
default value. 


The next Line is scanned for the presence of the indicator. 
Each occurrence of the indicator causes the character 
Girectly preceding it to be overwritten ody the character 
following the indicator. 


EXAMPLES: 
le The default character is the overprint indicator. 


Enter: .eOVERPRINT 
Sen/“orita 


Result :Sefiorita 
20 Change the overprint indicator to a "i". 


Fnters e0V 3 
GO3/TO3/ 


Result:GgTs 
36 Partially underline a worde 


Fnters: eOVERPRINT / 
F/_O/_RMAT 


Result FORMAT 
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§e3-30 New Paragraph 


2PARAGRAPH [C+] columns] 
= columns] 


Initial Value?’ 0 


Default: 0 or column count specified in the previous 
ePARAGRAPH requeste 


Breaks: yes 


This formatting request is used to indicate the start of a 
new paragraphe The request defines a change in tne Left 
margin for the next text line. It akso causes the new 
paragraph to be separated from preceding text by a number of 
blank Lines equal to the multiple spacing count (see .SPACE) 
plus one (1) Line. 


The argument "columns" specifies how many columns or 
character positions the Left margin is to be adjusted from 
its current setting. 


If the argument specifies a positive values the margin is 
moved to the right$ if negative, it is moved to the Lefte 


If the argument is omitted» the margin is adjusted according 
to the default valuee The default value Ys either the 
initial value of "0" or the value specified in the previous 
ePARAGRAPH requeste 


A special casey outdentingse occurs when the margin is 
adjusted to the left. In this cases text appears to trie left 
of the current Left margin settinge Any text appearing in 
this area is not adjusted» meaning that leading blanks = and 
multiple blanks between words are not deleted. This feature 
permits Labelling of paragraphse Any text appearing to the 
right of the Left margin is suoject to adjustment if eFILL is 
in effect. 


The examples given for the .INODENT requests to illustrate 
indenting and ocutdentings are equally valid for .PARAGRAPH. 
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Be3e3l1 Page Length 


ePLENGTH Lines 

Initial Value: 66 

Break: yes 
This formatting request defines the physical length of the 
page that will contain the formatted documente The argument 


"Lines" expresses the Length in number of Lines that fit on 
the page@e 


The top and bottom page marains are offsets within this 
Limite The initial value corresponds to a page Length of 11 
inchese 
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6Be53e52 Page Numbering 


ePNUMBER Cinitial] CelincrementiCscharacter]j] 


Initial Value: initial = 
increment 
character 


1 
% 


nue 


Oefault: initial = 1 at the start of formatting or 
the current calculated page count 
during formatting 


increment = 1 or the value soecified in 
Last ePNUMBE2 request 


character = % or the character specified 
in last ePNUMBER request 


Breaks no 


This formatting request initializes automatic page numbering. 


The argument "initial" specifies the page number that appears 
on the first formatted output page following tne request. If 
the argument is omitteds the page is numbered according to 
the current default value. 


The argument "increment" specifies the increment by which the 
page numbering counter is advanced after each page output. 
If the argument is omitteds the increment is the default 
value@e 


The argument "character" specifies a page number symbol. 
This symbol may be specified in the various page title 
requests available in OS/22 TEXT (see .3TITLE for an 
example). In the formatted outputs this symbol is replaced 
with the current page number. 


If the argument is omitteds the current default character is 
the opage number symbol. 


EXAMPLES. 


Request Explanation 
e~PNUMBER le2osa Pages are numbered starting with number lz, 


In odd numbers: le3e95e07 etce 
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ePNUMBER lO! 


ePNUMBER 


25 


To print the page number, the "3" must 
aopear in place of the page number 
tn a page title request. 


Assume the current default for 

"Increment"™ = le 

Pages are numbereds starting with number 10, 
in increments of ones l0ellel2el3vetce 

To print the page numoers, the "!" must appear 
in place of the page number in a page 

title requeste 


Assume twelve numbered pages 

have been output when this request 
is encountered and that the 
current page count = 13-6 


Pages are numbered starting with 

number 135 in increments of 5:3 

l39e1lBe23 settle 

The page number symbol remains unchanged. 
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6e3e33 Quit Processing 


eQUIT CALLI 
Initial Value: none 
Default: see text below 


Breaks: no 


This formatting request causes processing of the current text 
input to be terminatede If the argument ALL is specifieds 
all processing is terminated and control jis returned to the 
OS/32 TEXT command mode. 


If the argument is omitted, input termination and subsequent 
action depend on where the eQUIT request is encounterede as 
follows: 


o When eQUIT Ys encountered in an "“imbed" file (see 
eIMBED), input from that file is terminated and 
control returned to the source of the e~IMBED request. 


o When .QUIT is encountered during .RETURN processings 
control ts returned to the source of the eRETURN 
request. 


o When eQUIT appears in the text processed by the FORMAT 
commands all processing is terminated and control 
returned to the OS/32 TEXT command modee The text 
processed by the FORMAT command is the text that was 
entered using APPENDe etce or retrieved from a disc 
file using the GET command. 
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6e3e34 Return to User 


eRETURN Ccommentd 


Initial Values none 
Default: no comment displayed 


Sreaks no 


During the formatting process (fe@es when the FORMAT command 
is being executed) control can be switched temporarily to the 
command input device by using the eRETURN formatting request. 
At that times the user can enter document text and formatting 
requests at the command input device. This inout is 
processed immediately and becomes part of the formatted 
outpute Input is continued until terminated by entering the 
eQUIT formatting request or deoressing RETURN as the only 
input on a line. 


Text entered under the control of the eRETURN request is not 
inserted into the raw text which contains the e-RETURN 
request. 


The argument "comment" may contain alphanumeric user 
infornatione. This information is displayed on an interactive 
command input device only. It is intended to provide the 


user orompt regarding the type of data to be entered. 


eC ETURN cannot be used if the same device is used for command 
input and formatted outpute 
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603e35 Right Justify 


Initial Values ON 
Default: ON 
Sreak: yes 


When the ON argument is selectede this formatting request 
causes output lines to be justified against the right margin. 


If the argument is omitteds the ON condition is assumed. 
Right justification of output Lines is subject to the 
following considerations: 


0 When both eLJUSTIFY and eRJUSTIFY are ONe right 
justification is not done if eNOFILL is in effect. 


o The Last Line of a paragraphs or the Line preceding a 
formatting request which causes a break, is not right 
justifted when both eLJUSTIFY and eRJUSTIFY are ON and 
eFILL 38 tn effect. 


o Right justification is temporarily suspended by the 
eCENTER formatting request. 
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6e3e36 Revision Level 


eRLEVEL number C,Cleft columnilright column]) 


Initial Value: number=0 
Left column=10 
right column=76 


Default: left column - 2 columns to the Left of 
current Left margin 
right column =- 2 columns to the right of 
the current right margin 


Breaks no 


This formatting request controls the output and placement. of 
revision bars for text areas entered with the -eBAR requestaeo 


The argument "number" refers to revision level numbers 
entered with eBARe If "number" is greater than any revision 
Level in the texte no revision bars are outpute If "number" 
¥s not greater,e all revisions equal to or greater than 
"number" are identified with revision bars. 


The arguments "Left column" and "right column" specify the 
column numoer in the Left and right margins respectively in 
which the revision bars apdear in the formatted document. 


If the arguments are omitted, the revision bar columns” are 
computed to be 2 columns to the left for "Left column" and 2 
columns to the right for "right column" respective of the 
Left and right margin settings which are in effect when the 
eRLEVZEL request is encounterede 


EXAMPLESS 

le Assume three revisiton Levels (19293) exist in your texte 
No revisions are to be identified. 

Enters: eRLEVEL 4 

Result: No revision bars outpute 


Je Assume same text as in (1) above. Revision level 3 4s to 
be identified. 


Enters eRLEVEL 3 
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Result: ALL text entered under BAR 3 is 
identified with reviston barse 


3e Assume same text as in (1) abovee ALL e8AR 
made to the text are to be identified. 


Enters eRLEVEL 1 


Result: ALL text entered under .8AR 1 through 3 
fs identified with revision bars. 
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revisions 


6e3e37 Right Margin Adjustment (Relative) 


eRMARGIN C+} columns 
- columns 
RESET 


Initial Value: none 


Break: yes 


This formatting request allows you to make margin adjustments 
relative to the right margin currently in effect. 


The argument "columns" specifies the number of character 
positions by which the margin is to be adjustede The margin 
can be adjusted to the left (=) or to the right (*#). The new 
margin remains in effect until changed againe 


Each time a margin adjustment is made, OS/32 TEXT records the 
right margin setting that was in effect prior to the 
adjustmente A total of ten (10) margin adjustments can be 
recorded by OS/32 TEXT. 


The RESET argument is used to return the right margin setting 


from an adjustment to its previous’ settinge Multiple 
adjustments or resets may be verformed in succession. Each 
reset request correspondsse in reverse orders to its 


equivalent adjustment requeste 


If more RESET requests are entered than adjustments were 
made» the margins remain at the current settinge 


The recording table for the margin adjustments is cleared 
each time the FORMAT command is tssued or the eMARGIN request 
¥s processed. Please refer to .eLMARGIN for examples. 
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6203-358 Skip Line 


eSKIP Clines] 

Initiait Value: none 

Default: 1 

Break>? yes 
This request causes bDBlank Lines to appear in the formatted 
output. The argument "Lines" specifies how many blank Lines 
are to be outpute If the argument is omitteds one blank Line 
is output. The eSKIP request is subdject to the following 
considerations. 

o If the end-of-page is encountered dbefore all blank 

Lines specified in a request have been outputs output 


of the remaining Lines is inhibited. 


o If the output of blank Lines would occur at the top of 
a pages output of these Lines is inhibited. 


o If e-SKIP appears within a footnote it is ignored. 
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6e5e39 Multiple Spacing 


e SPACE Lines 


Initial Values 1 


Break: yes 


This request sets the spacing of text Lines. The argument 
"Lines" specifies the line spacing; 


1 


single spacing 


2 double spacing 


3 = triple spacing 


The value of "Lines" must be within the range of 1 through 6-6 


The eSPACE request affects only the text area in the 
formatted output. 


Text in footnotes is always single spacede 
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603040 Time of Day (from system) 


2lLIME Ccharacter] 


Initial Value: none 
Default: no character appended 
Breaks: no 


This formatting request reads the system clock and inserts 
the time of day into the formatted output text. 


The time is represented as an eight character string 
specifying hourS, minutese and seconds as follows: HH: MM:SS. 


The argument "character" specifies a single character which 
is appended to the time in the formatted output. This 
character is used to add punctuation to the time. 


EXAMPLE? 


Insert the time in the output and specify a sentence 
terminator. ; 


Enter: This example was done at 
oTIME 


Result: This example was done at 112232566 


29-677 ROO 2/79 655 


603041 Top Margin 


eL MARGIN Lines 
Initial Values: § 


Break: yes 


This formatting request specifies the number of blank Lines 
to occur at the top of each pagee 


When specified» the top page title is centered vertically 
within this spacee When the top margin is an odd number of 
Linese an equal number of blank Lines appear above and below 
the titlee When the top margin is an even number of Liness 
one more blank Line appears above the title than below the 
title. 
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6e3-42 Top Title 


el TITLE 4S1/82/83/ 
Initial Values none 
Break: no 
This formatting request is used to specify a page title which 


appears at the top of each page in the space defined as _ the 
too margine 


The top title may consist of up to three independent sections 
as defined by the argument /S1/S2/S3/.6 ALL three sections 
appear on the same Line in the top margin and are positioned 
as follows: 


o S1 is left justified 

o S2 is centered between the margins 

0 $3 is right justified 
Any of the three sections may be emptye Each section nust be 
separated by a delimiting symbol. In the above description, 
a stash "/* Ys usede Any characters, except a blanks may be 


used as the delimiter. The first character in the argument 
js assumed to de the delimiter. 


The page number symbol (see ePNUMBER) may appear in Sle S2-s 
or S3-e In the formatted outputs the page number symbol is 
reolaced with the computed page number for the current pagee 


Please see eBTITLE for examples. 
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603243 Underscore 


eUNDERSCORE 
Initial Values none 
Break: no 


This formatting request causes alphanumeric characters in the 
next text Line to be underscored. 


Non~alphanumeric characters (punctuation characterss 
parentheses» oracketSe etce) or parts of a word can be 
underscored using the .O0VERPRINT requeste To underscore 


blankse simply enter the underscore character in place of the 
blank. 


EXAMPLES: 

Enter: This is an example of 
eUNOERSCORE 
underscoring 
in 08/32 TEXTe 


Result: This is an example of underscoring in OS/32 TEXT. 
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6e5e 44 


Widow Prevention 


ew LOOWPREVENT CON] 


COFF] 


Initial Values ON 


Default: ON 


Break: yes 


This formatting request affects the placement of the first 
and Last Line of a paragraph in the formatted output. 


The request is subject to the following considerations: 


Oo When eFILL and eWIDOWPREVENT ON are selected, the 


fe) 


first line of a paragraph does not appear as the Last 
Line on a pages nor does the last Line in a paragraph 
appear as the first line on a page. 


When eWIDOWPREVENT OFF Js selectede atk paragraph 
Lines are treated as regular text linese 


When eWIDOWPREVENT ON and .~NOFILL are selected, all 
paragraph Lines are treated as if .eWIDOWPREVENT OFF 
had been selectede 
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6e5e45 Year (from system) 


eYEAR Ceharacter] 
Initial Value: none 
Default: no character appended 


3reak: no 


This formatting request reads the system clock and inserts 
the year into the formatted outpute The year is represented 
as a four digit number. 


\ 


The argument "character" specifies a single character which 
1S adpended to the year in the formatted outpute This 
character is used to add punctuation. Please see .eDAY for an 
examplee 
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6Ge4 TABLE OF INITIAL VALUES 


Many formatting requests have initial values which are set up 
automatically each time the FORMAT comnand is entered. These 
values are intended to orovide a standard format so that you 
can obtain formatted output with minimum initial setup. If 
these initial values are not suitabDles they can, of courses 
be changede 


The following table lists initial values of fornatting 
requests which have such values. 


Formatting Initial 
Request Vatue Comments 

e 3LANK $ Special blank indicator 

e8MARGIN 5 Sottom page margin = 5 Lines 

eCONTROL ° Formatting request control character 

eF ILL eF ILL Filling of outout Lines enabled. 

eHYPHENATE - Hyphenation indicator 

eL JUSTIFY ON Left Justification of output lines 
enabied. 

eL WIDTH 85 Physical page width = 85 columns 
(or character positions). 
85 corresponds to an 
8 1/2" paper widthe 

eMARGIN 12974 Left margin = 129 right margin = 74 
columns (Cor character positicns) 
counted from Left to right on 
the physical page (see 
eL WIDTH adove)e. 

eNOFILL oF ILL FALLing of output Lines enabled. 

eOVERPRINT / Overprint indicator 

«PARAGRAPH 0 No Left margin adjustment of first 
Line in paragraoh. 

ePLENGTH 66 Physical page Length = 66 Lines. 
This corresponds to an 11" page 
Lengths 
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Formatting 
Request 


ePNUMBER 


eRJUSTIFY 


eRLEVEL 


e SPACE 
eTMARGIN 


eWIDOWPREVENT 


Initial 
Value 


ro 


ON 


10 


76 


ON 


Comments 


FirstPage number 
Page number increment 
Page number symbol 


Rightjustification of output Lines 
enablede 


Cutput revision bars for all 
document revisions made with 
the eBAR request of revision 
Level 0 and greater. 

Column number to place revision bars 
in 

left margin 

Column number to place revision bars 

in 
right margin 


Single line soacing in effect 

Top page margin = 5 Lines 

When FILL is in effects first and 
Last lines of paragraphs do not 
appear on a different pagées 


separated from body of 
paragraphe 
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CHAPTER 7 
USE OF TEXT=II 


Tel GENERAL 


This chapter explains the use of OS/32 TEXT-IIs the version 
that contains only formatting capabilitys as explained in 
Chapter le 


The chapter assumes: 


o That you understand the use of TEXT=-I as described in 
this manuale 


o Tnat you know how to use OS/32 EDIT as described in 
the OS/32 EDIT User®s Manual, Publication Noe 29-516. 
Please note that the difference in usage between 0S/32 
EDIT and OS/32 TEXT=-I is the special TEXT=-I conmandss 
FORMAT and PRINT» which are not avaitable in 0OS/32 
EDIT. These commands are recognized ana processed by 
TEXT-IIe 


7Te2 CAPABILITIES 


The capabilities of TEXT-II are as follows: 


o Generates formatted output from document text and 
formatting requests contained in a fite which was 
previously created with 0OS/32 EDIT. 


co Prints a cepy of a formatted document which is 
ecntained ina file and was previously formatted with 
TEXT=-Ile 


o TEXT=-If recognizes only the following commands: 


END 
FORMAT 
GET 

PAJSE 
PRINT 
SEND STOP 
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The use of these commands is the same as described for 
TEXT-I.e Please note that before the FORMAT and PRINT 
commands can be useds the text file to be processed 
must be made available to TEXT=-II via the GET command. 


Loadings startings and task estadlishment are identical to 
the procedures described in Chapter 2 for TEXT-Ie To apply 


the descriptions in Chapter 2 to TEXT-IIe simply substitute 
the appropriate file name where reference is made to TEXT32e 


Following are two examoles illustrating the combined use of 
OS/32 EDIT and TEXT-IIe The examples use the simplest forms 
of Loading and starting these programs and apply to an OS/32 
MTM environment. The "*" and ">" symbols shown are MTM 
systen and TEXT=-II prompts respectivelys indicating that they 
are ready to accept a user responseée 


7Te2el Examole 1 


Enter document text and formatting requests into OQS/32 EDIT 
and save the text and formatting requests ina file named 
EXAMPLE ele Use TEXT=II to obtain formatted output of the 
document text saved in file EXAMPLE.1. 


User/Conputer Dialogue Description 
= System ready to accept a 
command 
*LOAD EDIT32.TSK User Loads EDIT32 
*START User starts EDIT32 
O0$/32 EDIT Rn EDIT32 displays 
identification 
? EDIT32 ready to accept a 
conmand 
>APPEND User requests text input 
mode 
1 > EXAMPLE NOe il User enters document 
2 > eSKIP text and formatting 
e > e requests 
* >? e 
e > RETURN User terminates text 


Input mode 
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User/Computer Dialogue 


>SAVE EXAMPLE 1 


>END 


USER=ID0 


-ENO OF TASK CODE=0 


*LOAD TEXTI2FM.TSK 


*START 


OS/32- TEAT=1>D an 


>GET EXAMPLE .1 


>FORMAT 


P=ORMAT EXALe= MT 


“ENO OF TASK CODE=0 
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Description 


EDIT32 ready to accept a 
conmand 


User saves text in file 
User terminates EDIT32 
ENDIT32 terminating nessage 


System ready to accept a 
commana 


User Loads TEXT=-II 
User starts TEXT-II 


TEXT=-II displays 
identification 


TEXT=-II ready to accept 
a comnana 


User makes document text 
to be processec avaitiable 
to TEXT-II 


User requests formattea 
output of document 
to default List device 


User requests a second 
formatted output sf the 
document to a file named 
EXA1Le& MT 


User terninates TEXT-II 


TEXTHII terminating 
message 


System ready to accept 
a command 


Te2ez Example 2 


Use TEXT-II to obtain a cooy of the document text which was 
formatted and output to file EXALeFMT tin Example 1. 


User/Computer Jialogue Description 


* System ready to accept 
a command 


*LOAD TEXT32FMeTSK User Loads TEXT-II 
*START User starts TEXT-II 
O$/32 TEXT-II Rn TEXT-II displays 


identification 


>GET EXA1lLeFMT User makes formatted 
document text to be 
processed available 
to TEXT=-IIle 


>PRINT User requests a copy 
of the formatted document 
to be output to the 
default List device. 


>PRINT PR8& User requests a second 
copy of the formatted 
document to be output 
to the printer. 


2END User terminates TEXT-IIle 

USER=-I0 “ENO OF TASK CODE=0 TEXT-II terminating 
message 

* System ready to accept 


a command 
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CHAPTER 8 
ERROR HANDLING 


Bel INTRODUCTION 


This chapter Lists and describes the messages output by TEXT. 


Section 8e2 contains the messages related to the use of TEXT 
commandsSe 


Section 8.3 contains the messages resulting from the use of 
TEXT formatting requests as they are processed by the FORMAT 
commande 


8e2 COMMAND ERROR MESSAGES 


This section lists messages which are output during 
processing of TEXT commands. 


In interactive modes message output is directed to the 
command device. Following the message outputs TEXT is in 
command mode awaiting the next user commande 


In batch mode messages are output to the list device. The 
first error message encountered causes the execution of TEXT 
to be terminated. 


The messages are divided into the following two groups: 


a) Syntax error messages, which are caused by=— an 
improper command formats 


do) Execution error messages» which are caused when TEXT 
cannct complete the execution of a command as 
specified by the operandse 


Within each group, the messages are listed in alphavnetical 
ordere The messages are based on the operation of the OS/32 
EDIT programe The descriptions given here are a summary of 
the chaoter on USER MESSAGES contained in the OS/32 EDIT 
User's Manuals Publication Noe 29=-576-6 You may refer to 
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this manual to supplement the information provided in this 


sectione 


B8e2el Syntax Errors 


ALL syntax errors messages are preceded by a question mark 
(7). A syntax error message is generated when TEXT cannot 
recognize the commands or the operande 


The current Line is not affected by a syntax error. 


MESSAGE DESCRIPTION 
27COLUMN # INCORRECT Column number appended to string 


operand is invalid. 


7COL WITHIN STRING A column specification for the 
OPERAND INVALID HERE reolacement string is not 
meaningful. 


2COMMA MISSING A comma is expected in the syntax but 
not founde 


P7COMMANO NOT RECOGNIZED An invalid command mnemonic has been 
enterede 


27FILE NAME INCORRECT Format of required file name invalid. 
See Chapter 5 for proper file 
Gescriptor formate 


?FILE NOT FOUND Syntax of the file descriptor is 
corrects but specified fite could 
not be found an the specified 
volumee 


27LINE OPERANO INVALID A Line specification is not a etLline 
number or string operand. 
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PFINYVALIOD COLUMN The column number is an invalid 
SPECIFIER number or exceeds the number of 
columns tn the current texte 


INIMBER INVALIO An operand mignt be a line number or 
an integer, but syntax is incorrect. 


PRANGE INVALIO Range operand is not recognized. 
Line specification may be wronge 
Separator is not a minus signe 


7STRING INVALID String operand incorrectly specified. 
Trailing delimiter might be missings 
or delimiter might not pe an 
acceptaole characierse 


Be2e2 Execution Messages 


ALL execution messages are preceded by an exclamation point 
C!'). These messages are generatec when TEXT cannot complete 
the execution of a command as specified by the operands. The 
command may have been partially executed on some of the 
specified text Lines. The TYPE command without an operand 
can be used to icentify the "current Line" at which execution 
of the command may have stoppecde 


Execution messages which indicate a more serious proolem are 
cenoted by two exclamation points. In some caseSs the only 
way to recover is to attempt to save the current texte (on a 
cifferent file from the source for GET)e and then to end the 
editing session and restart. 


MESSASE DESCRIPTION 

TOUPLICATE START An option is entered more 

DSF TION FOUND than once. 

I'r TLE ERRe» where: n=logical unit number 
LUYerefa r=reason 


fd=file daescriotor 


These messages are output when 
O0S/32 TEXT cannot resolve an 
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MESSAGE 


PINVALID BLOCK SIZE 


PINVALID COMMAND 
DEVICE 


PINVALID HEX CHAR 


SVC7 error internally. 
The possible reasons and corresponding 
SVC7 error status bSytes are: 


REASON SVC 7 ERROR STATUS 


ILLEGAL FUNCTION Q1 


LU ERROR 02 
VOLUME ERROR 03 
NAME ERROR 04 
SIZE ERROR 05 
PROTECT ERROR 06 


PRIVILEGE ERROR 07 
BUFFER ERROR 08 
ASSIGNMENT ERROR O99 

TYPE ERROR OA 

FILE DESCRIPTOR 03 

TGO ASSIGNMENT ERROR Oc 
ACCOUNT ERROR 00 
Refer to the 08/32 
Program Reference Manual » 


Publication Number 29-+613¢ for 
SVC7 error status byteSe 


DESCRIPTION 


The value specified for the BLOCK 
operand exceeds 255s or is invalide 


The device (or file) specified 
in the COMMAND option of the 
START command is synactically 
Incorrecte 


A specified string while the 


Hexadecimal option ts in effect 
contains an illegal hexadecimal digit. 
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TINVALID LIST OEVICE 


TINVALIO START 
OPTION 


'!I/O ERR LUN erefd 


MESSAGE 


TLENGTH OPTION 
NOT ACCEPTED 


'LINE NOT FOUND 


'LINE TQO LONG 
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* 


The device (or fite) specified in 
the LIST option of the START command 
is syntactically invalid. 


TEXT does not recognize an' 
ootion appearing in the START command. 


where: nzlLogical unit number 

r=reason 

fd=file descriotor 
These messages are output when OS/32 TEXT 
cannot resolve an SVCl error 
internally. 
The possible reasons and corresponding 
SVC1l error status bytes are: 


REASON SVC 1 ERROR STATUS 


ILLEGAL OR UNASSIGNED LU X*81° 


PARITY OR RECOVERASLE ERROR x*82? 


UNRECOVERABLE ERROR X° 84? 
END OF FILE X* 88 
END OF MEDIUM x* 90° 
DEVICE UNAVAILABLE X* AQ? 
ILLEGAL FUNCTION Xx*co? 


Refer to the 0S/32 

Program Reference Manual, Publication 
Number 29-613~¢e for a detailed 
exoOlanation of the SVCl error 

status bytese 


DESCRIPTION 


The LENGTH operand of the OPTION 
conmand is only acc2ptasle when no 
text is avaitable. 


Specified Line not present in texte 
The Line of text just entered while 


Tab Conntrol is in effect or a Line being 
changed is too Longs command processing 


Ss) 


LIST OPTION 


OMITTED-BATCH MODE 


INO TEXT 


!OPTION ERROR 
FOLLOWS XXXX 


FOP TION HEX NOT 
ALLOWED HERE 


'RANGE 1 NOT FOUND 


IRANGE 2 NOT FOUND 


ISYNTAX ERROR IN 
START OPTINS 


'TABS TABLE FULL 


TAB ILLEGAL 


TUNABLE TO ASSIGN 
LIST DEVICE 


stops and the Line which generates the 
message is not accepted. 


If the COMMAND option specifies 
a non-interactive devices TEXT 
assumes execution in batch mode. 
For batch mode executions the 
LIST option is required in the 
START commande 


No text jis available for editing. 


Option operand is not 
recognizeds XXXX are the 

Last four non-blank characters 
of the command that were recognizable. 
Command processing stops at the 
Last valid operand. 


le Hexadecimal mode is recognized 
only for commands that alter 
or display existing text. 


2e Option HEX cannot be selected 
if there is no current text. 


The first Line specification of 
the Range operand cannot be Located in 
existing text. 


This error message results when 

the second Line specification of the 
Range operand cannot be Located in 
existing texte 


The options itn the START 
command are incorrectly entered. 


No more tab points can be acceptede 
The maximum number of tab points TEXT 
can handle is 20.6 


Tao option incorrectly specified. 
Character given may be illegale 


The device (or file) specified 
in the LIST option of the START 
conmand cannot be assignede 


8e3 FORMATTING ERROR MESSAGES 
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This section Lists messages which are output as a result of 
oroblems encountered during the formatting of document text 
as requested by the FORMAT and PRINT commandse 


ALL messages are sent to the List device in both interactive 
and batch modese 


Formatting error messages are divided into the following two 
groups. 


a) Error Messagese which are caused by formatting 


request syntax errors and improper formatting 
request uSagey orevent the continuation of the 
formatting proceSsSSse Following output of an error 


message in interactive mode,» TEXT returns to the 
command mode and awaits the next user command. In 
batch mode» execution of TEXT ts terminated. 


b) warning messages, which result from improper use of 
formatting requests but whose effect is Less severes 
permit the formatting process to continuee [In 50th 
interactive and batch modess formatting continues 
after output of a warning messagee 


Error and warning messages have the following format: 


TEXT DIGNOSTIC AT LINE nnn FILE fa 
cCRROR XYY message 


or 


TEXT DIAGNOSTIC AT LINE nnn FILE fd 
WARNING XYY message 


where: 


nnn 4s the number of the tnput text Line which caused 
the message outpute This number corresponds to the 
Line number assigned to this text Line by TEXT 
during the editing process. I[t can therefore be 
used to tLlocate the tine in the raw document text 
for error corrections etCe 


Note, however, that when the text odbeing formatted 
contains fractional Line numbers (@egee 1eDlLeSeD 7s 
etce) it should first be SAVEG tn a file and then 
retrieved with the GET commande This procedure 
with renumber the text Lines and synchroniz2 them 
with the Line numbers itn the messages. 
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fd is a file name or a device mnemonic. If the text 
being formatted is contained in a files fd is the 
name of the file which contains the Line that 
caused the errore 


If the text being formatted was entered directly 
from the command input device (keyboards card 
reader)s fd represents the device mnemonic of that 
devices @eGee CONSe CRie etce 


X refers to one of the following message categories: 
G syntax error 
1 general diagnostic 
2 heading or footing diagnostic 
3 page dimension diagnostic 
4 page or line filling diagnostic 
> olock diagnostic 
6 word diagnostic 
7 function dtagnostic 
YY refers to the message number within a categorye 
message = is a brief description of the error conditione 


B8e3el Error Message 


In the following sections» error and warning messages. are 
Listed in numerical order by categories and error numbers. 


BSedseleli Category 0: Syntax Errors 


ERROROOL INVALIO FORMATTING REQUEST 


This error may be caused by the following conditions 
relating to the specification of a formatting request: 


o the request is misspelled or not all characters 
for the minimum abbreviation have been entered; 


o the request 3s not separated from its “first 
argument by at Least one blank3 
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0 a document text Line begins in column one with 
the control character reserved for formatting 
requestSe The CONTROL formatting request allows 
re-cefinition of the control character. See 
Chapter Se 


ERROROG2 INVALID ARGUMENT 


A formatting request contains an invalid argument. 
Verify the Oroper argument specification for the 
affected formatting request. 


ERROROO3 MISSING ARGUMENT 


A mandatory argument has been omitted from a_fornatting 
requeste Verify the proper argument specification for 
the affected formatting request. 


BeZale2 Category 1: General Errors 


ERRORLOL INVALID NESTING OF INPUT FILES 


This error is caused by too many Levels of inout nesting 
with the IMBEOD formatting request. Ten (10) £=files 
maximum may oe simultaneously open for impeddinge To 
remedy this conditions combine text from several files 
into one file to reduce the level of input nesting. 


ERRORLI2S NONEXISTENT PAGE NUMBER 


A page nunber specified in the FORMAT command does not 
exist in the document peing formatted. 


ERRORLIOS SO INPUT TEXT 


This error is caused when the FORMAT and PRINT commands 
are entered and no text ts available for orocessinge To 
use the PRINT commancy text must first be mad2 avatlaosle 
to TEXT via the GET command. To use the FORMAT commands 
text must first be entered into TEXT from the command 
device or retrieved from a file via the GET commande 
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ERROR1O4% DATA INTEGRITY CHECK 


This error can occur when using the PRINT command to 
print apreviously formatted file. It is possible that 
the user tried to manipulate the data within the file 
and hence the file cannot be processed by the PRINT 
commande 


ERROR1O5 IMBEO FILE ERROR fd 


An attempt was made to assign the file fd as an Imbedded 
Filee The assignment failede The file name fd could be 
mistyped, or assigned exclusively to another rune 


Bedeled Category 23 Errors tin Page Headings and Footings 


ERROR2O1 TITLE SPECIFICATION IN ERROR 


An error occurred in the title specification of a TITLE 
or BTITLE formatting requeste It is usually caused by 
inconsistent use of or missing title delimiters. Refer 
to Chapter 6 for proper format to specify top and bottom 
Sage titles. 


Besdele4 Category 33: Page Dimension Errors 


ERROR301 BOTTOM MARGIN ERROR 


The bottom margin specified in the BMARGIN formatting 
request is a negative number or greater than the 
difference between the defined page Length (PLENGTH) and 
the top margin (TMARGIN).- The bottom nargin must be in 
the following range: 


0 > 3MARGIN > CPLENGTH=TMARGIN) 


ERROR302 TOP MARGIN ERROR 


The top nargin specified in the TMARGIN” formatting 
request 4s a negative number or greater than the 
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difference between the defined page Length (PLENGTH) and 
the potton margin (BMARGIN)« The topo margin nust be in 
the following range: 


0 ¢ TMARGIN ¢€ (PLENGTH-BMARGIN) 


ERROR3O03 MARGIN SPECIFICATION ERROR 


The margin settings specified in the MARGIN formatting 
request are in error for one of the following reasons: 


Oo both margins specify the same setting; 


o the Left margin setting is greater than the right 
margin settings 


o either one or both of the margin settings 
specifies a setting that falls outside the 
physical page width as defined by the Line width 
CLWIDTH) formatting request. 


The margin settings must be in the following range: 
0 ¢ Left Margin < Right Margin <¢ LWIOTH 
ERROR304 LINE WIOTH ERROR 


The number specified in the LWIDTH formatting request is 
outside the legal rangee The Line wiath must be in the 
ranges: 


1 < LWIDTH ¢ 132 
ERROR305 PAGE LENGTH ERROR 
The number specified in the PLENGTH formatting request 


4s outside the legal rangee The page length must be in 
the range: 


1 ¢ PLENGTH ¢< 65536 
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BereleS Category 4:2: Errors Caused by Filling Pages 
and Lines 


ERRORGO01 WIDOW PREVENTION =ZRROR 


The argument specified in the eWIDOWPREVENT formatting 


request 4S not one of the two Legal keywords - ONe OFF 
- for this requeste 


ERRORGO2 MULTIPLE SPACING ERROR 


The number specified in the SPACE formatting request is 
outside the Legal rangee The multiple soace count must 
be tn the range: 


1 < SPACE ¢ 6 


ERROR403 INDENT SPECIFICATION ERROR 


The number specified in the INDENT request causes an 
adjustment to the current left margin which places the 
start of the next Line outside the boundaries of the 
Shysical output page. 


Be3ele6& Category 5: Errors Caused by Blocks and Footnotes 


ERRORSO1 ILLEGAL NESTING OF BLOCKS» KEEPS» OR FOOTNOTES 


This error %S caused by attempting to nest the 
formatting requests which define 3lockss Floating Keeps 
and Footnotese Use of these requests within themselves 
or within each other is illegal. 


The error also occurs when the END delimiter of a 
previously started Blocks Keep or Fostnote request was 
omitted and a second BEGIN delimiter for any one of 
these requests is encountered. 


ERRORSO2 TOO MANY FOOTNOTESs BLOCKS» OR KEEPS 
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Many footnotes blocks or keen formatting requests have 
been entered in close successione The document should 
oe changed to make these structures larger or _ space 
these formatting requests farther apart. 


ERRORS5O3 INSUFFICIENT MARGIN FOR REVISION BAR 


The RLEVEL- formatting request specifies use of the 
default column positions for the revision bars on the 
output page but there is insufficient room on the margin 
to place the oarse 


The default positions for the revision bars are computed 
to be two (2) columns to the left and right respective 
of the Left and right margin settings which are in 


effect when the RLEVEL request is encountered. If one 
of the resulting revision bar positions falls outside 
the ohysical output pages this error message is 


generated. 


ERRORSOC4S MAXIMUM NUMBER OF FOOTNOTES EXCEEDED 


This error is caused when output of ten (10) footnotes 
is pending and another footnote request is encountered. 


To alleviate this probleme try to spread out the 
definition of footnotes to provide sufficient output 
pages so that TEXT can complete the output of each 
footnote as tt is encountered. 


Besele7? Category 63 Word Diagnostics 


ERRORSO1 ILLEGAL OVERPRINTING 


The overprint request is being used to overprint one 
character more than three timese Change the input text 
to avoid thise 


Be3e2 Warning Messages 
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Bede2e0 Category 0: Syntax Warnings 


WARNINGOOl INVALID ARGUMENT 


Extraneous characters occur on the request Lineée The 
request was accepted and the valid arguments were 
proceSSede The Line should be checked for errors, 


Be3e2ei Category 1: General Warnings 


WARNING1O1 THE eRETURN REQUEST WAS ISSUED ILLEGALLY 


Document text and formatting requests are currently 
being entered under the control of the RETURN request. 
Another RETURN request cannot be entered at this time. 


BeSe2e2 Category 2: Warnings in Page Headings and Footings 


WARNING20O1 INSUFFICIENT SPACE FOR PAGE NUMBER 


The text for the title sections of a Top or Botton page 
title does not leave sufficient roome after the sections 
are positioned on the output page, to accommodate all 


digits for the page numbere 
BeSe2e3 Category 3: Page Jimenston Warnings 


WARNING301 INVALID MARGIN SET OR RESET 


More than ten margin changes were specified without 
doing a resete A margin reset request was encountered 
without a preceding margin adjustment request. The 
current margin settings remain unchanged. 


Bede2e4 Category 4: Warnings Caused By Filling Pages 
and Lines 
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WARNINGSO1 CENTERING ALREADY IN EFFECT 


This warning message is output when two successive 
CENTER BEGIN formatting requests are encountered without 
an intervening CENTER ENO requeste 


WARNINGSO2 INPUT TOO LARGE FOR OUTPUT LINE 


This error occurs when filling of output text lines is 
inhtbiteq - NOFILL is in effect - and the current input 
Line is longer than the available space in the outdut 
Line. The current margin settings deternine the 
availaole space in the output lLinee The input Line will 
be truncated tn the formatted outpute 


Berse2e5 Category 53 Warnings Caused by Blocks 
and Footnotes 


WARNINGSC1 REVISION SAR SLOCKING IS ERRONEOUS 


Text to be identified with revision bars must de defined 
Dy BAR BEGIN and BAR ENDO formatting requestse TRYs 
warning itis issued when: 


o two (2) successive BAR BEGIN requests are 
encountered without an intervening BAR’ END 
requests or 


oO a BAR END request is encountered without a 
oreceding BAR BEGIN requeste 


WARNINGSC2 BADLY STRUCTURED BLOCK», KEEPs FOOTNOTEs OR CENTER 


This message is tssued when one of these formatting 
requests contains a SEGIN argument and is not terminated 
by a request containing an END arguments or when an END 
argument is used when no previous 83EGIN argument is 
uUSede 


Besde2e6 Category 63 warnings Caused by Words and Characters 
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WARNING6O1L NO OVERPRINT CHARACTER APPEARS IN THIS LINE 


An OVERPRINT request was encountered but the following 
text Line does not contain the currently defined 
overprint symbole 


WARNINGSO02 NO SPECIAL=BLANK CHARACTER APPEARS IN THIS LINE 


A BLANK formatting request was encountered but the 
following text line does not contain the currently 
defined special blank symbol. 


WARNING603 NO HYPHENATION CHARACTER APPEARS IN THIS LINE 


A HYPHENATE formatting request was encountered but the 
following text Line does not contain the currently 
defined hyphenation symbol. 
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APPENDIX A 
COMMAND SUMMARY 


The underlined letters in each command are the minimum abbreviation 
requirede Commands may be entered in upper or lower casee 


MNE MONIC OPERANDS* CURRENT LINE COMMENTS 


APPEND none Last Line entered 
CHANG= SleS2ok Last Line of range 
COLUMN CeSoR Last Line of range 
DELETE R Line following 
Last Line deleted 
ENO 
FINO Sok Last Line of range 
FORMAT fdspages ALL operands can be 
null 
HALT oX2EF 
GET fd first line of fd 
INCLUDE LefdeR Last Line inserted Lefd can be null 
INSERT L Last Line inserted L can be null 
QPTION BLOCK=n Uncranged for default values: 
LENGTH=n all operands BLOCK =5 
LIST=fd LENGTH=80 
LOG=fd LIST=aeterminead 
by START command 
MODE=ASCII MODE=ASCII 
or HEX 
NOLOG NOLOG 
NOTAB NOTASB 
NOVERIFY TZRMINATOR= 


TAS=charystoDdys 
StOP ee 
TERMINATOR=char 


VERIFY 
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unspecified 


VER TEY 


APPENDIX A (Continued) 
COMMAND SUMMARY 


PAUSE unchanged 

PRINT fd not applicable fd can be null 

REPLACE R Last Line inserted 

SAVE fdeR Last Line output R=null=entire file 

SEND STOP Last Line Operating System 

processed command 

LYRE R Last Line of range 

+ n Line output Nn=null=l=carriage 
returns next Line 
7s output 

- n Line output n=null=1:s previous 
Line is output 

Line noe text Line number referenced 

none Line following 


deleted Line 


*x* § = string operand fd = file descriotor 
R = range operand L = L operand = §$ or Line noe 
C = column number n = integer 
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APPENDIX A (Continued) 
COMMAND SUMMARY 


FORMATTING REQUEST SUMMARY 


Underlined tLetters in each formatting request and argument 


represent the ninimum abbreviation required. Arguments 


tn 


brackets are ootionals arguments in braces indicate alternate 


choic®2. 


The Initial Values are automatically set upd each tine 


FORMAT command is enterede 


the 


The Default Values are substituted when an optional argument 


is omitted. 


A formatting request which causes a break interrupts 
output Lines when FILL is in eftect. 


Formatting reauests and arguments may be entered in upper 


Lower CaSé@e 


INITIAL 
REQUEST & ARGUMENTS VALUE DEFAULT VALUE 
eGAR BEGINenumber none N/A 
ENO 
efLANK Ccharacter] $ $ or character 
specified in last -8LA 
2BLOCK BEGIN none N/A - 
END 

eo EMARGIN Lines 5 N/A 

2S QLDFACE none N/A 

aGREAK none N/A 

2PTITLE S1/S2/83/ none N/A 

eCENTER BEGIN none next text Line only 

ENO 
2cOMMENT note none N/A 
eCONTROL character e (period) N/A 
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filling 


or 


BREAK 


Yes 


No 


Yes 


Yes 


Yes 


Yes 


2DAY Ccharacter] 


eEVENBOTTOM /S1/S2/8S3/ 
eEVENTOP /S1/S2/83/ 


2EILe 


eFOOTNOTE BEGIN 
END 


eHYPHENATE Ccharacter] 


INDENT C+dJcolumns 
- columns 


“KEEP 3EGIN 
END 


eLJUSTIFY ON 
QEF 


APPENDIX A (Continued) 
COMMAND SUMMARY 


none 
none 
none 
none 
eFILL 


none 


-(dash) 


none 


none 


none 


ON 


mo character appended 
N/A 

N/A 

N/A 

N/A 

N/A 

-(dash) or 

character 


specified in 
Last .HY 


N/A 


N/A 


ON 


No 


Yes 


No 


No 


Yes 


No 


No 


No 


Yes 


Yes 


Yes 
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REQUEST & ARGUMENTS 


eL LENGTH columns 


C+Jcolumns 
- columns 
RESET 


eLMARGIN 


MARGIN Lefteright 


2MONTH Ccharacter]) 


eNQETLL 
eODOBOTTOM /S1/S2/83/ 
eODDTO® /S1/S2/83/ 


eOVERPRINT Ccharacter] 


2PARAGRAPH C+Jcolumns 
- columns 


ePLENGTH Lines 
sPNUMBER Cinitial] 


Celincrement] 
CeCincrementj] 


eRETURN Ccoomment J 


eRJUSTIFY ON 
QFF 


RLEVEL number 
eCleft cold 
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c 


APPENOIX A 


(Continued) 


COMMAND SUMMARY 


INITIAL 
VALUE 


66 
initial=1 


increment=l 
character=% 


none 


none 


ON 


number=0 
Left col=10 


DEFAULT VALUE 


N/A 


N/A 


N/A 


no character 
appended 


N/A 

N/A 

N/A 

f/ or character 
specified in 
Last eOV 

0 or column 
count specified 
in Last ePA 

N/A 


initial=l 


formatting 
iIncrement=1 or value 
character=% character 

specified 


in Last .PN 


Return control to: 
1. Source of IMBED 
requeste or 


2@e Source of RETURN 


requests or 
Se TEXT command itnout 


no comment displayed 


ON 


N/A 


Left coltl=2 columns to the 


at start of 
formatting or 
the current 
calculated page 
count during 


Yes 


No 


Ceright cold) 


eRMARGIN 
RESET 
eSKIP Clines] 


eSPACE Lines 


el JME Ceharacter] 


IMARGIN Lines 
el TITLE /S1/82/83/ 
2eJNDERSCORE 


eWIDOWPREVENT 0 
QFF 


eYEAR Ccharacter] 


C+Jcolumns 
- columns 


APPENDIX A (Continued) 
COMMAND SUMMARY 


rght col=76 


none 


none 


Left of current Left margin 
right col=2 columns to the 
right of current right 


margin 


N/A 


i 
N/A 


no character 
appended 


N/A 
N/A 
N/A 
ON 


no character 
appended 


No 


Yes 
Yes 


No 


Yes 
No 
No 


Yes 


No 
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APPENOIX 8 
TASK ESTABLISHMENT 


The following sequence can be used to establish O0S/32 TEXT as 
a segment task from an object version named TEXT.0O8UJ: 


*LOAD TET32 

#ASSIGN SeCON: 
*ASSIGN 7,CONS 
zSTART 

PESTASLISH TASK ePURE 
PINCLUDE TEXT.O0B8U 


>EXPAND n 
>BUILD TASK eTEXT32 
PEND 


The use of the EXPAND command provides work space memory “for 
TEXT whitch may improve response time when editing text 
consisting of many Lines in very Large files. 


TThe argument "n" ds expressed as a number of 256 byte blocks 
of memory that is added to the task*s Impure area. It should 
have a minimun value of 1 to provide space for START 
Darameterse 


The size of the workspace created by the TET32 EXPAND commanc 
may be overridden at Load time. The "seg-size increment" 
argument itn the LOAD command overrides the amount of work 
soce memory allocateed for the task by TETe The seg-size may 
be specified in e25K8 increments. 
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INDEX 


APPEND commands 3°29 3-30 5-9 
Asgcsing text 

during editinge 3-4 

during formattinge 4-16 


BAR requeste 42159 6-7 

Batch mode»y 2-5 

BLANK requests 6-8 

RLOCK requeste 3-279 3-289 32-299 6-9 
BMARGIN requests 3-169 3720¢ 4-99 6-10 
BOLOFACE request, 6-11 

Bottom margins 3-209 4-99 6-10 

Bottom titles 3-15, 3-169 3721s 6-13 
BREAK request, 3-30, 3-319 6-12 

BTITLE requests, 3-169 3-219 6-13 


CENTER requests S3-16¢ 3-219 6-15 
Centering texts 4-29 6-15 
CHANGE commands 3-59 38% 5-11 
Changing papers 4-18 
Changing texts 3-5¢e 4-4 
COLUMN commands 5-13 
Command 

definitions 4-1 

descriptionse 5-69 5-7 

devices 2-3 

error handlinge 8-1 

mod@s 4-2 

operand formats, S=-2 

Summarys A-1 

syntax, 5-1 

usages 4-3 
Communicating with TEXT» 2-4 
COMMENT requests 3-169 3°209 4-169 6-16 
CONTROL requests 6-17 
Copies of formatted outputs 4-7 
Creating texte l-1l 
Cross reference Listings 4-6 
Current tines 5-79 5-8 


Datinge automatice 3-219 37349 6-189 6-379 67-559 6-60 
DAY requests 3-329 3°34¢ 6°18 
Default valuese 

formatting requests A-3 
DELETE commands S3-1lle 3-129 5-14 
Deleting filese 4-21 
Sevice 

command, 2-3 

List, 2=<3 
Display file names 4-21 
Document texte 4-3 
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INDEX ¢€Continued) 


Editing examples, see Examples, editing 
EJECT requeste 6-19 
END commands 37i2s 5-15 
Entering texts 3-le 4=3 
Error handling 
command errorses 8-1 
correction in texte 3-40 4=4 
formatting errorss 8-63 8-7 
formatting warnings», 8-15 
Even bottom titles 6-20 
EVENBOTTOM requests 6-20 
Even top titles 6-21 
EVONTOP requeste 6-21 
Exampless editing 
error corrections 3-4 
retrieving texts 3-10 
Saving text, 3-10 
tab settings 3-24, 3-25, 3-28 
text addition, 3-4 
text deletions 3-10 
text entry, 3-1 
text insertions 3-4 
text reviews 3-2 
text searches 3-10 
Examplese formatting 
automatic datinge 3-31 
footnotes, 3-15 
Line controle 3-154 3=<31 
merging texts 3-31 
page Layout, 3-15 
page numbers, 3-15 
page titless 3-15 
Simole requeste- 3-1 
tables» 3-249 3-259 3-269 3-279 3-28 


File 7 
deletions 4-21 
descriotor operands 5-5 
handlings 4-20 
name displaye 4-21 
namings 4-20 
FILL request,» 37-269 3-299 6-22 
Filling Lines,» 4-105 6-22 
FIND commande 3-l1le 5-16 
Floating keepe 6-31 
FOOTNOTE requests 3-159 3-179 37189 37-229 6-24 
FORMAT commands 3°15¢9 3-229 4215 
FORMAT commande 3749 4-39 4-6¢ 5-18 
Formatted output 
copies of» 4-59 4-6 
Droducings 4-5¢e 5-18 
Formatting examples» see Examplese formatting 
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INDEX (Continued) 


Formatting requests 1-29 3-1 
definitions 4-2 
descriptionss 6-19 6=5 
errorss 8-9 
summarye A353 
syntaxs 8-8 
usages 4-7 
user interactions 4-169 8-479 6748 
warningss 8-15 


GET command,» S3elle 32149 5-21 


MYPHENATE requeste 6-25 
Hyphenation, 6-25 


IMBED requests 3-319 3-329 4-l1l7le 6-27 
INCLUDE commande 4-4, 5-22 
In context aslocks 6°79 
INDENT request, 3-269 3*239 421259 6-29 
Indentings 3-25¢ 3-285 4-129 6-29 
Initial values» 4-189 6-61 
INSERT commands 3-4-9 3-59 3-79 4-4e 5-24 
Inserting text 

Guring editings 3-49 4=4 

during formattings 6-48 
Interactive modes 2-4 
Introduction to formattinge 3-1 


KEEP requests §=-31 


Left justifications 4-109 §=-32 
Left margin adjustment, 3-179 3-229 4-99 6-34 
Line 
currents S-79 5-8 
fillings 4-10 
number commande 5-43/5=-44 
numberse §-3 
orinters i147 
Skiosinge 3-179 3-219 7-53 
SOacings 3-59 3°79 3S-2le 32229 3-169 3-179 3-219 3-229 6-54 
widths 4-85 4-95 6-33 
List device, 2-3 
Listings cross references 4-69 5-18 
LUUSTIFY requests, 4-109 6-32 
LMARGIN requests 3-179 3-225 4-109 6-34 
Loading TEXT 
MTM environmente 2-2 
OS$/32 environments 2-1 
LWIDTH requests 4-7¢e 6-33 


Margins bottoms 3-169 3-208 4-99 6-10 
MARGIN requests 3-159 3-209 4-99 6-36 
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Merging text 
during editinge 4-4, 


Messages 
command error, 8-1 
formatting error, 8-6 


5-22 
during formatting, 3-31, 


4-159 6-27 


formatting warnings 8-15 
MINUS sign command, 5-42 
Mode 

batches 2-6 

command, 4-2 

interactives 2=-4 

text, 4&=—2 
Modifying texte 3-49 4-4 


MONTH requests 3-31, 


4-20 
3-269 


Naming filese 
NOFILL requests 


ODOSO0TTOM requests 6-40 
Odd bottom titles 6-40 
ODDTOP requests 6-4l 
Odd top titles 6-41 
Operand formats s 
OPTION commands 
Ootions 
Lengths 
Lists 
notabs 
noverifye 
tabs 5-29 
verifys 5-30 
Overprintings 6-lle 
OVERPRINT requests 


3-259 


39-26 

5-28 
5-28 

9-29 


6-42 
6-42 


Page 
ejects 
Layouts 


6-19 
3-159 4-7 
Lengths 4-9, 6-44 
numbperS, 3-15, 
Setuds 4-759 4-8 
standard Layouts 
titless 3-155 4-14, 
Papers changings 4-17 
PARAGRAPH request, 3-29 
PAUSE commands 5-31 
PLENGTHe 3-2¢ 3-39 4-7, 
PLUS sign commands 5-41 
PNJIMBER requests 6-45 
PRINT commands 4-79 5-32 
Prompt suppressitony 4-17 


4-79 


QUIT request,» 4-169 §-47 


Index-4 


3-289 


commands 


S7529 3-339 6-37 


3-299 4-139 6-38 


= a4 


3-289 5-26 


4—14¢ 6-45 


4=8 
4-15 


3=-4— 4-99 4-135 6-43 


6-44 
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Raw texts 4<3 

REPLACE commands 5-35 

Retrieving texts 3-106 4-5 

RETURN requeste 4-169 6748 

Reviewing texts 3229 4=3 

Revision identifications 4-156 6-7¢ 6-50 
Reviston levels» 4-14, 6-50 

Right justifications 3-179 3-219 3-229 6-49 
Right margin adjustments 3-175 3-219 3-223 4-99 6-52 
RJUSTIFY request» 3-179 3-219 32-22¢ 6-49 
RLEVEL requests 4-155 4-169 6-50 

RMARGIN requests 3-179 37229 4°99 6-52 


SAVE commande 3e-lle 327129 5°37 
Saving texts 3-109 4=5 
Searching texts 3-109 4-4 
SEND STOP commands 5-39 
Sentence terminatorse 4-12 
SKIP requeste 2-179 3-2le 4-139 6°53 
Skip Linese 3-174 3-219 4-136 6-53 
SPACE requeste 3-169 3-21le 471346 6-54 
Spacings Lines 3-5¢ 3-79 3°169 32-219 6-54 
Spectal blanks 46-8 
Standard page lLayoute 4-7¢e 4-8 
Starting TEXTe 2-2 
Summary 

commande A-l 

formatting requeste A-3 
Syntax 

commande 5-1 

formatting requests, 6-5 


Tab settings 3°24 5 3-259 3-286 4-149 5-29 
Table formattings 3-24 9 37-254 3-28, 4-13 
Taple placement, 4-13 
Task Establtishnente 8-1 
Terminal Use» 2-4 
Terminating TEXTs 3-10, 5-15 
Terminators, sentences 4-12 
Terminology definitionsse 4-1 
Text 
addition, 3-4 
changings 3-496 423 
creatings 1-1 
definitions 4-1 
Geletione 3-10 
enterings 3-ls 4-3 
error corrections 3-49 4-4 
insertions 3-4, 4-4 
mergings during editings 4-45 5-22 
merginge during formattings 3-319 4-199 6-27 
modee 4=2 
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retrievals 3-105 4-5 
reviewings 3-24 4-3 
Savings 3-109 4-5 
Searchs 37109 4=4% 
TEXT=Ie 1-2 
TEXT=II 9 1-20 1-3/1-4, 7-1 
TEXT program 
communication withs 2-39 2-4 
guide to features, 4-1 
Loading, 2-1 
startinge 2-2 
task estaodlishments B-1 
termination, 3-10 
TIME requests 3-319 3-326 6-755 
Title 
bottoms, 3-15¢ S219 4°99 6-13 
even bottom, 6-20 
even tops 6-21 
odd bottom, 6-40 
odd tope 6-41 
Coos 37-159 4-99 6-57 
TMARGIN request, 37159 3-206 4-99 6-56 
Top margins 3-159 3-209 4-99 6-56 
TTILE requests 3-159 3-219 6-57 
Top titles 3-155 3-219 6-57 
TYPE commands 3-290 3-49 3-79 4-49 5-40 


UNDERSCORE requests 3-169 3-219 6-58 
Versions of OS/32 TEXTs 1-2 
wWIDOWPREVENT requests» 6-59 


YEAR requests 3-319 3-349 6-60 
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